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Chapter 1 
Introduction 


The NEC Advanced Personal Computer (APC) consists of two principal compo- 
nents: the processing unit and the keyboard. 


The processor unit houses the control processor unit (CPU); this is the brains of the 
computer. The processor unit also houses the memory, the display screen, and the 
brightness and volume controls. The volume control adjusts the sound levels of the 
blipping sound the computer makes on the response to the various functions that 
are on the keyboard. 


The keyboard attaches to the rear of the processor unit with a five-foot coiled cable. 
Its 109 keys include a typewriter layout, a numeric keyboard and 22 user definable 
function keys. 


The APC prints copies of its data on a printer. NEC printers that work with the 
APC are the Spinwriter 3530, 7730, and the APC Dot Matrix printer. The Spinwri- 
ter 3530 and 7730 produce letter-quality, fully-formed characters. The APC Dot 
Matrix Printer prints all standard characters in a variety of sizes and styles as well as 
any special graphics you create using the APC's auxiliary character generator. 


In terms of software, the APC supports a number of operating systems, including 
CP/M-86* and MS-DOS1. Software for communications, business, and financial 
applications is available from numerous sources. 


A typical APC has on its front face a visual display (CRT), one or two 8-inch 
diskette drives, and a speaker. The brightness and volume controls are located 
under the drives. The power switch is located under the CRT. 


* CP/M-86 is a trademark of Digital Research, Inc. 
T MSDOS is a trademark of Microsoft, Inc. 
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CONFIGURATIONS 


АРС-Н01 


PROCESSOR UNIT WITH MONOCHROME 
DISPLAY AND ONE DISKETTE DRIVE 


APC DOT MATRIX PRINTER 
OPTION 


KEYBOARD 


| АРС-НО2 
PROCESSOR UNIT WITH MONOCHROME 
DISPLAY AND TWO DISKETTE DRIVES 


SPINWRITER 3530 
OPTION 


KEYBOARD 
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APC-H03 
PROCESSOR UNIT WITH COLOR DISPLAY 
AND TWO DISKETTE DRIVES 
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7730 SPINWRITER 
OPTION 


KEYBOARD 


APC USED AS TERMINAL TO COMMUNICATE WITH LARGER COMPUTER 
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HARDWARE OPTIONS 


Various hardware options are available for the APC, including devices for printing, 
communications, and data storage, among others. 
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SOFTWARE OPTIONS 


A variety of software is available for the APC, including operating systems, 
business applications, communications software, and higher level languages. 
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Chapter 2 
Unpacking and Assembly 


Unpacking and assembling your APC are simple procedures requiring only a few 
minutes and no special tools or equipment. 


The APC comes in two cartons. The smaller carton contains the keyboard. The 
larger carton contains the processor unit that houses the display screen, disk drives, 
and memory. The larger carton also contains warranties and documentation. 


After unpacking the APC, save the cartons and all packing materials. You can use 
them when relocating your APC over long distances. 


To open the larger carton, remove the four plastic lock clips by squeezing and 
pulling lock as shown. 


BR | SQUEEZE AND PULL 


2-1 


Unpacking and. Assembly 


Remove the top of the carton, then carefully lift the processor unit.* Place it 


securely on a flat working surface that allows access to the front and back of the 
unit. 


Remove these items from the carton: 


e Warranty cards 
e Diagnostic test diskette 
е All documentation 


Remove the protective plastic covering from the processor unit and any pieces of 
tape that adhere to the housing. Next, remove the protective inserts from the 
diskette drives as shown in the following figures. 


* Lifting the processor unit may require a second person. 


^^ 


I 
|. 


SQUEEZE THEN 


Ей RELEASE ТО OPEN 


Remove the small panel from the back of the processor unit as shown. 
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Unpacking and. Assembly 


PROTECTIVE 
INSERT 


Unpacking and Assembly 


Behind the panel are the connectors for the keyboard (KBD), printer (PTR), and 
communications devices (COM). Other units may have connectors labelled KB 
(keyboard), ODA (printer), and CMA (communications devices). 


1А 


Now open the smaller carton, remove the keyboard, and place it next to the 
processor unit as shown. 


VEL mm 


Slightly lift the rear of the processor unit. Slip the plug of the keyboard cable into 
the slot under the left side of the unit. Plug the keyboard cable into the connector 
labelled KBD. Securely lock the connection with the clips provided and connect the 
grounding wire as shown. 


CONNECTOR 
LOCK CLIP 


GROUNDING 
CLIP 


If you have a printer or communications device to attach to the APC, connect it 
now. Refer to Chapter 5 of this guide or the documentation provided with the device 
you are connecting. 


Replace the panel on the back of the processor unit when all necessary cables аге 
attached. 


Connect the APC power cord to a properly grounded wall outlet. 


Unpacking and. Assembly 
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Unpacking апа Assembly 


NOTES 
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Chapter 3 
Keyboard 


The functions of some keys on the APC keyboard shown below depend on the 
operating system in use as well as individual application programs. However, the 
keys generally perform as they are labelled. Always refer to the manual pertaining 
to the particular program (BENCHMARK, MicroPlan, etc.) you're using to find 
out exactly what each key does. 
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Use these keys to move the cursor. 
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Use these keys like a calculator. 
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Use these keys to access any additional character sets. 


Keyboard 


Keyboard 
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Chapter 4 
Diskettes 


The APC uses 8-inch diskettes to store operating systems, application programs, 
text, and data. The amount of information you can store on a diskette depends on 
the type you use. You must observe the following cautions for diskettes when using 
your APC: 


€ Never insert any diskette before the APC is turned on. 
€ Never turn off the APC until all diskettes are removed. 


€ Never insert a diskette into a drive when the red light next to the drive is lit. 
If this happens, remove the diskettes and turn off the APC. Turn the APC 
on again, insert the diskettes, and close the doors. The diskettes will start to 
load. 


TYPES OF DISKETTES 


The APC supports the use of the following diskettes. Density refers to how much 
information can be stored in a physical location on the recording surface. Double- 
density diskettes store twice as much information in the same location of the surface 
as single-density diskettes. 


e Single-sided, single-density diskettes store about 243 kilobytes of information. 
This represents nearly a quarter of a million characters of program informa- 
tion or data. Only one side of the diskette is used. 


ө Dual-sided, double-density diskettes store about 1,000 kilobytes, the equivalent 
of approximately one million characters. Both sides of the diskette are used. 


The diskette, as shown below, is flat and circular. It is contained in a square 
permanent jacket that protects the magnetic surface, but allows the diskette to spin 
freely when inserted in the drive. 
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Diskettes 
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LABEL 
INDEX HOLE 


JACKET 


HEAD ACCESS SLOT 


As the diskette spins, the read-write head of the diskette drive reads (locates) or writes 
(places) data on the magnetic surface through the head access slot. The read-write 
head uses an index hole as a reference point for locating information in specific areas 
on the diskette. 


AREAS ON THE DISKETTE 


The read-write head locates or places information on the diskette in areas called 
addresses. Addresses consist of track, cylinder, and sector locations. 


The information written on the diskette is placed along a track. One side of a 
diskette contains 77 tracks, which are actually concentric circles as shown below. 
All of these tracks are available for storing programs and data after the diskette has 
been formatted or prepared for use. 


On single-sided diskettes each track is also called a cylinder. On dual-sided diskettes 
the corresponding tracks on each side of the diskette are together called a cylinder. 


Each track of an 8-inch diskette is further divided into 26 sectors. The information 
contained in a single sector shown below is the smallest unit that the read-write head 
can locate on the diskette. 
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Each sector contains a specific amount of information, depending on whether the 
diskette is single-density or double-density. The sectors of a single-density diskette 
contain 128 bytes (a byte represents one character). The sectors of a double-density 
diskette contain 256 bytes. 


The following table summarizes the characteristics and capacity of the two types of 
diskettes. 


Total Total Bytes Per Total Bytes 
Diskettes Tracks Sectors Sector Per Disk 


1,025,024 
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CARE OF DISKETTES 


Follow these precuations to ensure that your programs and data are not destroyed 
or damaged. 


e Be sure to turn on the APC before installing a diskette. 


e Hold a diskette by the edges of its protective jacket. Do not touch the 
unprotected areas of the recording surface. 


e Be sure to remove the diskette before turning off the APC. 


e Place diskettes in their sleeves when not in use. Hold the corner of the sleeve 
when inserting or removing the diskettes. 


e Write on diskette labels with a felt tip marker only. 
e Do not bend or fold diskettes. 


e Do not expose diskettes to dust, extreme temperatures, or magnetic fields. 
Telephones, electronic calculators, and paper clips are common items that 
contain magnetic sources. 


e [nsert and remove diskettes carefully in drives. Do not close a drive cover on 
an improperly inserted diskette. 


e Store unused diskettes in proper storage boxes. 
e Do not lay heavy objects on top of diskettes. 
e Do not clean diskettes surfaces. 


INSERTING DISKETTES INTO DRIVES 


To prevent possible damage to the diskette first turn ON the POWER to the 
processor unit for either the one or two 8-inch diskette drives, depending on your 
system. The two-drive (“А" and “В” drives) system and the power switch are shown 
below. 
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Diskettes 


To insert a diskette into a drive, open the drive door by squeezing the door latch, 
then releasing the latch as shown. 
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Diskettes 


Hold the diskette so that the label side of the jacket faces the display screen. Insert 
the diskette so that the head access slot enters the drive first as shown below. 


HEAD ACCESS SLOT LABEL 


\ 4 
ho e 
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The diskette slides easily into the drive. When almost all the way into the drive, the 
diskette meets some resistance from a spring-lock mechanism. Gently push the 
diskette the remaining distance into the drive (approximately 17% inches) until you 
hear the click of the locking mechanism. 
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Diskettes 


The diskette is now locked in the drive. Squeeze the drive door latch closed. If the 
door remains open, the system will not be able to do any functions on the disk in 
that drive. 


To remove the diskette, squeeze the door latch. The spring-lock mechanism releases 
the diskette as the drive door opens. 


LOADING SOFTWARE 
APC diskettes contain a variety of software, including the following. 


e Systems programs 

e Application and utility programs 
e Data 

e Text 


If your APC has one diskette drive, all information is accessed from the single drive. 
This may mean that all of the types of software listed above are found on a single 
diskette. Or you may have to exchange diskettes in the drive at specific points 
during processing. 


If your APC has two drives, the operating system, programs, and data may be 
located on diskettes in one or both drives. The particular operating system and 
programs you use determine many of the procedures for accessing information on 
diskettes. Refer to the documentation provided with your oftware for procedures 
on loading and operating. 


Diskettes 


NOTES 
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Chapter 5 
Printers 


You can use a variety of printers with your APC, including the APC Dot Matrix 
Printer* and the 3530 Spinwriter shown below. 


APC DOT MATRIX PRINTER 
3530 SPINWRITER 


CONNECTING YOUR PRINTER TO THE APC 


Both of the printers shown above attach directly to the APC parallel interface or 
connector. The interface is labelled PTR and is located behind the small panel on 
the back of the processor unit. To connect either of these printers, use the parallel 
printer cable, Model АРС-Н21. 


Place the printer near the processor unit. Make sure that the power switches on both 
the printer and APC are turned off. Open the back panel of the processor unit and 
connect the APC-H21 cable to the PTR interface as shown. Use the lock clips 
provided on both the PTR interface and the printer to secure the connection. 


The following sections briefly describe the APC Dot Matrix Printer and the 3530 
Spinwriter. For additional information refer to the documentation provided with 
your printer. 


* The PC-8023A Dot Matrix Printer can also be used with the APC. It is functionally and operationally 
equivalent to the APC Dot Matrix Printer except for a few differences " и (һе special graphics symbols it prints. 
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Printers 


CONNECTOR 


CONNECT THIS END TO THE PRINTER CONNECT THIS END TO THE APC 


DOT MATRIX PRINTER 


The APC Dot Matrix Printer is an impact-type, high-speed dot matrix printer. Dot 
matrix characters are formed by a pattern of small dots. The printer uses a 7 
(horizontal) by 9 (vertical) dot matrix for alphanumeric characters and an 8 by 8 
matrix for special characters and graphics. 


The APC Dot Matrix Printer prints bidirectionally at a speed of approximately 100 
characters per second. Up to 136 characters per line can be printed. A variety of WA 
print styles and sizes 16 available. 


Operation 


After you have cabled the APC Dot Matrix Printer to the PTR connector and 
connected the power cord to a properly grounded wall outlet, turn on the power 
switch located on the left side of the printer. The illustration below labels the parts 
of the APC Dot Matrix Printer that are described in the following sections. 


RELEASE <> PAPER 
S$ COVER 
PLATEN = 
ROLLER 
PAPER SHAFT 
CUTTER = 
WET T ы PLATEN 
СС) KNOB | 
p = Бр МА 
CONTROL "A 
PANEL 
CARRIER 
COVER 
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Control Panel 


The control panel, located at the top right of the printer, has three pushbutton 
switches marked SEL, LF, and TOF. The panel also has one red and two green 
indicators. When you turn on the power switch, the green POWER indicator lights 
up. The green SEL indicator shows the status of the SEL switch described below. 
The red PE indicator lights up when the end of paper is detected. 


SEL PE POWER 


SEL L.F T.O.F. 
ооо OUU 


The three pushbutton switches on the control panel operate as follows: 


e Select switch (SEL) — Pressing this switch changes the status of the printer 
from online to offline. Use this switch as a pause button to temporarily halt 
or deactivate the printer. Pressing this switch also sets the top-of-form 
position. The SEL indicator lights up when the printer is online. The 
indicator is off when the select switch is deactivated, the end of paper is 
detected, or the printer carrier cover is removed. 


e Line feed switch (LF) — Pressing this switch causes the printer to perform a 
single line feed. If the switch 1s held, the printer continues to perform line 
feeds until the switch is released. However, the LF switch only works when 


the printer is not selected. Check that the SEL indicator is not lit before 
pressing the LF switch. 


e Top of form switch (TOF) — Pressing this switch causes the printer to 
advance the paper to the top-of-form position. If the switch is held, the 
printer continues advancing the paper until the switch is released. However, 
the TOF switch only works when the printer is not selected. Check that the 
SEL bulb is not lit before pressing the TOF switch. 
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Other Switches 


Other switches that control character size, line spacing, and other functions are 
located inside the APC Dot Matrix Printer beneath the carrier cover. Facing the 
rear of the printer, set the slide switches as shown below for most APC applications. 


Loading Paper 


The APC Dot Matrix Printer uses single sheets of paper and continuous forms such 
as paper rolls and fanfold paper. When the end of any of these types of paper is 
detected, the PE (paper end) indicator lights up. To load more paper, remove the 
paper cover, pull the paper cutter forward, and pull the roller shaft away from the 
platen. Push the release lever back (lining it up with the PIN FEED label) and 
remove any paper remaining in the printer. 


REMOVE PAPER 


PUSH RELEASE 
LEVER BACK 


Printers 


LOADING CONTINUOUS FORM PAPER 


е Open the tractor covers located on each of the two sprocket tractors. 


е Position the paper feed holes on the tractor pins. If the pins do not line up 
/” with the feed holes, adjust one or both tractors. Push the tractor lock lever 
| back to release the tractor. 


NOTE 


The movement of the left tractor is restricted. 
Usethe right tractor to perform the majority of 
paper alignments. 


TRACTOR LOCK 
LEVER 
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Printers 


e Closethe tractor covers. Turn the platen knob clockwise until the end of the 
paper appears at the front of the platen. 


e Return the roller shaft to its original position. Make sure the release lever is 
set on PIN FEED. Turn the platen knob clockwise to move the paper to the 
top-of-form position. 


LOADING SINGLE SHEETS OF PAPER 
е Close the tractor covers located on each side of the two tractor sprockets. 
e Push the release lever back, lining it up with the PIN FEED label. 


e Insert the end of the sheet of paper at the back of the platen and push the 
paper until it appears at the front of the platen. 


e Align the ends of the paper to ensure a proper feed. Center the paper along 
the platen as necessary. 
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e Lock the paperin place by pulling the release lever forward, lining it up with 
the FRICTION label. 


e Roll the platen counterclockwise until the top of the paper is in the desired 
position. 


e Return the roller shaft to its original position. 


Installing and Replacing the Ribbon Cartridge 
The APC Dot Matrix Printer uses the type of ribbon cartridge shown below. 


Printers 
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Printers 


REPLACING THE RIBBON CARTRIDGE 


e Turn off the power. Remove the paper cover and carrier cover. 


e Move the print head to a position along the platen where no rollers are on 
the roller shaft. 


e Remove the old ribbon cartridge by spreading the cartridge springs on each 
side with your fingers as you lift the cartridge. 


CARTRIDGE 
LOCKING SPRING . 


INSTALLING A NEW RIBBON CARTRIDGE 


е Before installing the new ribbon cartridge, turn the knob of the cartridge 
driver clockwise to tighten the ribbon. 
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Printers 


CARTRIDGE 
DRIVER 


e Insert the top of the ribbon between the ribbon guide plate and the ribbon 
guide of the printer. Once the ribbon is in position, push the cartridge onto 
the ribbon deck, fitting the two guide spikes on the bottom of the cartridge 
into the holes on the ribbon deck. See if the cartridge supporters firmly hold 
the cartridge in place. If they do not, press on the cartridge while turning the 
cartridge driver clockwise. The cartridge should lock into place. 


e Replace the paper cover and carrier cover. 


Forms Thickness Control 


When printing multipart forms, carbon copies, or thick paper stock, you may have 
to adjust the forms thickness control. To do this, first remove the carrier cover. 
Forms thickness adjustments are controlled by the red lever on the right of the 
printer as shown below. 


FORMS 
THICKNESS 
CONTROL 


Q 


NP 
реа 


When using multipart forms or thick stock, press this lever forward to move the 
print head away from the platen. Push the lever back for normal thicknesses. 


Printers 


Self- Test 
The APC Dot Matrix Printer is equipped with a self-test for checking basic printing 
functions. To perform the self-test, use the following procedure. 


e Return the print head to the home position by turning the power switch on 
and then turning it off. 


e Load paper into the APC Dot Matrix Printer until it appears at the front of 
the platen. 


e Turn the power switch on while simultaneously pressing the TOF switch. 
Then release the TOF switch. 


The printer automatically prints a pattern of alphanumeric and graphic characters 
in various sizes and styles similar to the one shown below. 
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The pattern repeats indefinitely. To stop the self-printing test, turn the power switch 
off. 
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3530 SPINWRITER 


The 3530 Spinwriter is a letter-quality printer that gets its name from the thimble- 
shaped print element that spins during operation. These print thimbles come in 
several dozen interchangeable typefaces, each containing up to 128 fully formed 
characters. 


The 3530 Spinwriter prints bidirectionally at a speed of approximately 35 characters 
per second. The number of characters that can be printed on a line depends on the 
size and style of the print thimble chosen, as well as other variable factors such as the 
spacing between characters. 


Operation 


After you have cabled the printer to the PTR connector in the back of the APC 
processor unit, connect the power cord to the Spinwriter as shown below. Before 
turning on the Spinwriter, make sure the top cover and acrylic cover are tightly 
closed. Press the power switch on the rear of the printer. The POWER indicator on 
the control panel lights up. 


The illustration below labels other parts of the Spinwriter described in the following 
sections. 
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Control Panel 


The control panel, located on the front of the printer and shown below, consists of 
several switches and indicators. 


О 
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SET TOF OVERRIDE FF RESET 
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FORM LENGTH 


The following describe the switches and indicators on the control panel. 
e POWER — This indicator lights up when the power is on. 


e RESET — Pressing this switch allows you to recover from an alarm 
condition. 


e FF — Pressing this switch advances the paper to the top-of-form position. 


e READY — This indicator lights up when the printer is ready to receive data. 
The indicator is off when the LOCAL switch is pressed, the ribbon is out, 
the printer is initializing, or the cover is open. 


e RIBBON — This indicator lights up when the end of the ribbon is detected. 
e PAPER — This indicator lights up when the end of the paper is detected. 


ө ALARM — This indicator lights up when the printer detects an error in the 
signal it receives, the paper jams, or other problems occur. 


e OVERRIDE — Pressing this switch allows the remaining text on the page to 
be printed when the PAPER indicator lights up. 


e LOCAL — Pressing this switch changes the status of the printer from 
remote mode (online) to local mode (offline). When in local mode, the 
indicator over this switch lights up. 


e SET, TOF — Pressing this switch defines the form length, the number of 
lines to be printed on each page, according to the value set by the FORM 
LENGTH switches. The current print line is defined as the top of the form. 


e FORM LENGTH — Use these switches to set the length of the form up to 99 
lines. 
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Other Switches 


Other switches on the far left side of the front panel control proportional spacing, 
line spacing, self-testing, and other functions. Set these switches as shown below for 
most APC applications. The 3530 also has internal slide switches. For assistance іп 
setting these switches, contact your Dealer or Authorized Service Center. Refer to 
the documentation provided with your Spinwriter for additional information. 
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Loading Paper 


The paper loading procedure depends on the forms-handling option you use with 
your printer. The following procedure describes how to load paper into a Spinwri- 
ter equipped with a cut sheet guide as shown below. If your Spinwriter has some 
other forms-handling option, refer to the instructions that accompany that option. 
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e Slide and hold the left edge guide to the first print column you select. 


e Move the paper release lever to the back position. 
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e Align your forms with the left edge guide and place them so they evenly 
contact the pressure rollers along the paper support. 


e Move the paper release lever to the center position. The Spinwriter auto- 
matically loads the form to a preset location, and the print head moves to 
the center of the carriage. If the form does not load properly, repeat the 
previous steps. 


e Move the paper release lever all the way back. (The exact position of the 
release lever depends on the forms-handling attachment you are using.) 


Replacing, Reversing, and Installing the Ribbon Cartridge 


Your Spinwriter prints with a long-life black or red/black fabric ribbon and a single 
color multistrike film ribbon for the 3530 Spinwriter. Change the fabric cartridge 
periodically to maintain sharp, dark printing. Flip the multistrike ribbon cartridge 
when the POWER/FAULT light is blinking; replace the multistrike ribbon car- 
tridge when the POWER/FAUL T light is blinking and the letter quality is no longer 
crisp and clear. The part numbers for replacement ribbons are listed in the table 
below. 


MULTISTRIKE RIBBON CARTRIDGE FABRIC RIBBON CARTRIDGE 


Available Ribbons for 3530 Serial Printer 


ТҮРЕ OF RIBBON MODEL PART NUMBER 


Black Fabric 808-862739-101 
Red/Black Fabric 808-862739-102 
Black Multistrike 808-862740-101 
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NOTE 


If you need to change the ribbon cartridge 
during printout (a blinking fault alarm occurs), 
do not turn off the printer. Part of the data and 
the printer parameters (tabs, margins, forms 
length, and so forth) will be lost. 


REMOVING A RIBBON CARTRIDGE FROM. THE MODEL 3530 
e Raise the top cover. 


e Hold the ribbon cartridge with one hand, gently spread the right locking 
spring, and lift the cartridge out. 


e Remove the belt from the top of the multistrike ribbon cartridge. Invert the 
cartridge and install the belt on the other side. 
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е When inverting the ribbon, press the cartridge switch to the right in the 
direction of the arrow on the cartridge. 
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Cartridge 
Switch 


INSTALLING A NEW OR INVERTED RIBBON CARTRIDGE 


@ Turn the manual feed knob on the new or inverted cartridge in the direction 
of the arrow to put some tension on the ribbon. 


@ Place the left pivot of the cartridge into the left hole of the Spinwriter 
cartridge frame. Make sure that the right pivot of the cartridge goes com- 
pletely into the right locking spring hole of the frame. Install the ribbon 
between the card holder and card holder bracket. 


€ Turnthe manual feed knob on the new or inverted cartridge in the direction 
of the arrow to ensure proper seating of the cartridge and to put tension on 
the ribbon. 


е Close the top cover and turn on the printer’s power switch. 


Installing and Changing the Print Thimble 
Print thimbles, represented below, are available in a variety of type sizes and styles. 
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Thimbles сап be interchanged whenever necessary. 

REMOVING A PRINT THIMBLE FROM THE 3530 SPINWRITER 
e Raise the top cover. 
e Remove the ribbon cartridge as described in the previous section. 


e Lift the hammer cover from the right side. 


HAMMER COVER 
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€ Locate the lock in the center of the thimble, slide it to one side, and pivot it 
to a vertical position. 
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e Lift the thimble from the carriage. 


NOTE 
Hold the thimble at the center to avoid damag- 
ing the character surface. 


INSTALLING A NEW THIMBLE 
e Make sure that the lock piece is in a vertical position. 


ө Place the new thimble in position by aligning the square hole in the bottom 
of the thimble with the square block insert on the thimble holder. 


€ Gently press the thimble down to make sure it is in place. 

e Slide the lock piece down into a horizontal position and lock it in place. 
e Push the hammer assembly back down into position until it locks in place. 
ө Install the ribbon cartridge as described in the previous section. 


e Close the top cover. 
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Self-Test 


The Spinwriter is equipped with a self-test for checking basic printing functions. To 
run the self-test, use the following procedure. 


ө Turn off the printer. 
ө Load 16-inch wide, continuous form paper. 
e Set the FORM LENGTH switch to 13. 


ө Make sure the SP and ГЕ switches on the control panel are set properly for 
the thimble being used. 


e Setthe TEST switch on the control panel to the up position as shown below. 


Printers 


ө Turn on the printer, making sure it is in the local mode. (Press LOCAL to 
change from remote to local mode.) 


TheSpinwriter hasa self-test that prints a stored message line by line in a repeating 
pattern. To stop the self-test, turn off the printer. 
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OTHER MODELS ОЕ SPINWRITERS 


The APC can support the 7730 and 5530 Spinwriters when the slide switches are set 
properly. 


7730 Spinwriter 


The control panel slide switches for the 7730 are on the far left of the printer. Set 
these switches as shown below for most APC applications. The 7730 also has 
internal slide switches. For assistance in setting these switches, contact your dealer 
or authorized service center. Refer to the documentation provided with your 
Spinwriter for additional information. 


MODEL 7730 OPERATOR CONTROL PANEL SWITCHES 
SW2 SW3 


1 "ON" 
0 "OFF'' 


1 "ON" 
О "OFF" 


5530 Spinwriter 


The slide switches for setting the 5530 are internal to the printer. For assistance in 
setting these switches, contact your dealer or authorized service center. 
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The APC is equipped with two test programs. One operates internally (Resident 
Test) and the other is loaded from a diskette (Test 82). 


RESIDENT TEST 


The resident test is performed inside the APC every time the processor unit is turned 
on. The test requires a fraction of a second to run, after which it returns a visual or 
audible message to indicated results. The following table lists these messages to help 
the operator when calling the dealer or authorized service center for help. 


* ROM T&D has found no failures; 
system ready for operation 


Diskette Drive Status Error 


DMA LSI Register ERROR 


Memory IC Write/Read Error 


K 


Keyboard Flag Error 


Tone But No Display CRT LSI Status Error 


No Visible Or Audible Indication see text below 


Turn on the power and see if the light switch comes on. 
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If no message is displayed on the APC after the power has been turned on, follow 
these steps. 


ө Turn off the APC power switch. 
e Make sure that the APC has been connected to an ac outlet. 


@ Make sure that the APC volume and brightness controls have been adjusted 
properly. 
е Turn on the power and see if the switch light comes on. 


e If the APC still does not display a message, call your dealer or authorized 
service center center for help. 


TEST 82 


Test 82 consists of a series of test programs stored on a diskette that allow the user to 
verify proper operation of the APC. 


Startup Procedure and General Instructions for Test 82 


Turn on the power to the printer and APC. When the asterisk appears at the upper 
left of the APC display, insert the Test 82 diskette into drive A. Always insert a 
diskette so that the label faces to the screen. Close the drive door. You will hear the 


diskette spinning as the test loads automatically. LOD appears at the upper left of © 


the display but is soon replaced by a prompt. To display the main menu shown on 
the screen in the following illustration, hold down the control key (CTRL) and press 
BREAK STOP. 


Choose a test by entering its two-digit code, then press the ENTER key twice. The 
chosen test loads and then displays prompts. Use only the tests described in this 
section. 


C. 
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QJ. KE OF, IGA 


ог. MM TEST Jt 3t JE JE 3E 40 36 18 3E TEST 


оз, FL TEST 3t 4t 3E 3E 3E 36 3E 3E 3E TEST 


O4.PRINTER TEST 3t 3E 330 3E 3E 3E 3E 3E TEST 


OS, S30 TEST 3t 3t 36 SE 3E 36 3E 3E 3E TEST 


06. 


СЕТ TEST 3t 3t 3E JE 4E d 3€ 3E E TEST 


WATCH TEST j£ 3t 3t 3E 3E 3E 3E 3E 3E TEST 


a. S102 TEST Jt 3t ЗЕ 3€ 3€ dE 3E 3E 3E TEST 


THE ITEM DEZIRELDL 
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The key functions table describes special controls used for Test 82. 


CTRL and BREAK Pressing this key removes an error condition and 
makes the system ready to accept the next command. 


GRPHI Locking this key down at the start of any test causes all 
remaining tests to be executed. This key also functions 
as a repeat for tests 1 through 5 when using Test 82. 


FNC and BREAK Holding down the FNC key and pressing BREAK 
STOP STOP returns Test 82 to its initial display. 


CTRL and BREAK Holding down the CTRL key and pressing BREAK 
STOP STOP returns you to the main Test 82 menu screen. 


BACK SPACE Pressing down this key moves the program one step 
backward. With the keyboard test, hold down the FNC 
key and press BACK SPACE for the key to work in this 
test. 


Usually, pressing the BACK SPACE key at the end ofa 
test will return you the subtest menu. 


Diskette Loading Problems 


This section describes problems detected in a loading of Test 82. A visual or audible 
alarm messages signal a loading error has occurred. This portion also lists a series of 
remedies that correct a diskette loading error. 


LOADING ERROR MESSAGE (LER) 


The LER messages tells you that a loading error has occurred. Open the drive A 
door, turn the power switch off and on, then reinsert the diskette. If you get an error 
after three tries, use the following procedure. 


ө Make sure that you did not leave the drive door open when loading. 
е Try loading the system diskette in drive B (if available). 
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ө Load another program into the drive. If loading is successful, the Test 82 
diskette is faulty and should be discarded. 


ө If the problem continues, call your dealer or authorized service center for 
help. 


LOADING (LOD) NOT INDICATED 


If, after several unsuccessful attempts at loading the diskette, the LOD message 
does not appear and the asterisk remains on the screen, follow this procedure. 


ө Check that the diskette drive ready light under the identifying letter of the 
drive is on. If it is not, make sure you have inserted the diskette properly. 


e Try loading from diskette B (if available). 


Ф Load another program into drive A. If loading is successful, the Test 82 
diskette is faulty and should be discarded. 


e If the problem continues, call your dealer or authorized service center for 
help. 
NO REGISTRATION MESSAGE 


This message indicates that a diskette other then Test 82 has been installed in the 
diskettes drive. 


e Make sure that the Test 82 diskette has been inserted. 


е Insert the Test 82 diskette in drive B (if available). 


е Insert another program diskette in drive A. If loading is successful, the Test 
82 diskette is faulty and should be discarded. 


e If problem continues, call your dealer or authorized service center for help. 


DISKETTE READ ERR MESSAGE 
This message indicates a disk loading error has occured. 


ө Replace the Test 82 diskette with a new Test 82 diskette and reload. 
ө If problem continues, call your dealer or authorized service center for help. 


Testing Your APC 
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Keyboard Test (01) 


This program tests the keyboard unit. To select this test, type 01 and press the 
ENTER key twice. A prompt is displayed. Two general categories of keyboard test 
can be selected. 


ө Free Test — This test allows the operator to select any key to be displayed on 
the screen. You should select this test when you suspect a particular key is 
faulty and want to test it. 


e Guide Test — This test displays keys in a dictated sequence for the operator 
to follow. 


To perform the Free Test, press keys in any order and view them on the screen to see 
if the correct character or characters are displayed. If the wrong character is 
displayed, repeat the testing of the key several times. If the errors continue, call your 
dealer or authorized service center for help. 


The keyboard Guide test consists of a Key-In Test, which guides you key by key 
through the entire keyboard (except switch keys). If an error appears, call your 
dealer or authorized service center for help. 


To return to the program menu, hold down CTRL and press BREAK STOP. 


Memory Test (02) 


This program tests the memory system and should be performed by your dealer or 
an authorized service representative for best results. 


Diskette Drive Test (03) 


This program tests the diskette drive. There are two test modes that appear on the 
prompt. Only the Multi- Track Mode should be performed by the operator. 


To start this test, select 03 from the Test 82 menu then press ENTER twice. Select 
test 1 (Multi-Track Mode). Choose the drive that has Test 82 in it: 1 will select drive 
A, and 2 will select drive B. An abnormal end to the program causes the alarm to be 
sounded. If this happens, call your dealer or authorized service center for help. 


Printer (ODA) Test (04) 


This test exercises the printer with a test message for the APC Dot Matrix printer 
only. It needs some special cables when performed by your dealer or authorized 
service representative for best results. 


Communication Adapter (SIO) Test (05) 


This test checks the serial input/output communications interfaces. This test needs 
special test adapters and should be performed by your dealer or authorized service 
representative for best results. 


Video (CRT) Test (06) 


The cathode ray tube (CRT) test is actually a series of tests that examines the display 
unit. Select it from the main menu by typing 06 and press the ENTER key twice. The 
next screen is a prompt that lists several subtests to choose from. To select any 
subtest, type the test number and press the ENTER key twice. If you want to view 
the test more than once, lock the GRPH2 key in the down position. Unlocking the 
GRPH2 key will cause the test to stop at the end of the cycle. At the end of the 
subtest, return to the prompt by pressing the BACK SPACE key. To return to the 
program menu, hold down CTRL and press BREAK STOP. 


ө CRT MEMORY TEST (1) — This test checks the display memory using 
dynamic patterns on the screen. This test takes about three minutes. When 
the test indicates a result of Chip Location (*IR*), Address (*0000*), and 
Base Address (*4*), the memory program has come to a normal end. 


Press CLEAR HOME and continue to the next test. If any other result is 
shown on the screen, call your dealer or authorized service center for help. 
For the next five tests, if an abnormal end is detected to the program an 
alarm is sounded. If this happens, call your dealer or authorized service 
center for help. 


е ANK DISPLAY TEST (3) — This test checks the contents of the character 
generator for direction and location. When this test is started, the displays 
appear in sequence. If you want to stop action on the screen, lock the 
GRPH2 key down and press FNC. 

е CRT ATTRIBUTE TEST (4) — This test makes sure that all characters аге 
fully formed and have the proper attributes. If you have a color display unit, 
this test also shows the available colors on the screen. 


e SCROLL TEST (5) — This test examines the scrolling feature of the screen 
displayed. Use the GRPH2 and FNC keys to control this test. 


e CURSOR TEST (6) — This test examines the display cursor. Use the 
display, checking the blinking rates of the cursor. 


e DISPLAY UNIT TESTS (0) — This test fills the display with characters. 
Use the GRPH2 and FNC keys to control this test. 


Testing Your APC 
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Watch Test (07) 


The Watch Test checks the operations of the battery and calendar/clock circuit. It 
shows the on/off status of the clock output and tests the battery that operates the 
calendar/clock. This test is selected from the main menu by typing 07 and pressing 
the ENTER key twice. The next screen you see is the watch test. This test repeats 
until the FNC key is pressed down. If the display indicates BATTERY STATUS 
(DWN), call your dealer or authorized service center for battery replacement. If the 
battery is OK, but the pulse status changes from ON and OFF, call your dealer or 
authorized service center for help. 


Communication Adapter (SIO2) Test (08) 


This test is а system communication test that should be performed by your dealer or 
authorized service representative. 


IOA Test (09) 
The test has not been defined at this time. 
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When moving the APC over long or short distances, follow these procedures for 
disassembling the various devices. 


e Remove diskettes from the drives. 


e Turn off the power switches, including those on printers and other optional 
devices. Disconnect, coil, and secure the power cords. 


Disassembly and Repacking 
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e Disconnect all cables and grounding wires from the back panel of the 
processor unit. Coil and secure the cables. 


When relocating the APC over short distances, move the keyboard, processor unit, 
and all other devices separately. Have a second person help you carry the larger 
pieces, such as the processor unit. Once the units are relocated, cable the APC as 
described in Chapter 2. 


For long distance moving, repack the processor unit and keyboard as described in 
the following section. Use the original cartons and packing materials if possible. 


REPACKING THE PROCESSOR UNIT 
e Put a protective insert in each diskette drive and close the drive door. 


Disassembly and Repacking 


e Put the plastic cover over the processor unit. 


e Carefully lift the processor unit (with help from a second person) and situate 
it squarely on the foam cushions in the bottom half of the packing carton. 


e Replace the top half of the carton. Insert a plastic lock clip in the holes 
provided on each side of the carton. 
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Disassembly and Repacking 


e Put the plastic cover over the keyboard. 


REPACKING THE KEYBOARD 


e Carefully lower the keyboard into its carton. 


7-4 


Disassembly and Repacking 


e Tape the cover of the carton using a strong tape. 


> 


(6 


d 
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DN 


Carefully repack optional devices such as printers using the original cartons and 
packing materials if possible. 


S 


Follow the instructions in Chapter 2 for unpacking and assembling the APC at its 
new location. 
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Disassembly апа Repacking 


NOTES 
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Chapter 1 
Introduction 


ASSEMBLER OPERATION 


ASM-86 processes an 8086 assembly language source file in three passes and 
produces three output files, including an 8086 machine language file in hexadecimal 
format. This object file may be in either Intel or Digital Research hex format, both 
of which are described in Appendix C. ASM-86 typically produces three output files 
from one input source file as shown in Figure 1-1. 


LIST FILE 
SOURCE >| АЅМ-86 HEX FILE 


SYMBOL FILE 
filename.A86 — contains source 
filename.LST — contains listing 
filename.H86 — contains assembled program in hexadecimal format 


filename.SYM — contains all user-defined symbols 
Figure 1-1 ASM-86 Source and Object Files 


Figure 1-І also lists ASM-86 filename extensions. ASM-86 accepts a source file with 
any three letter extension. However, if the extension is omitted from the command 
line entry, ASM-86 looks for the specified file name with the extension .A86 in the 
directory. If the file has an extension other than .A86 or has no extension at all, 
ASM-86 returns an error message. 


The other extensions listed in Figure 1-1 identify ASM-86 output files. The .LST file 
contains the assembly language listing with any error messages. The .H86 file 
contains the machine language program in either Digital Research or Intel hexa- 
decimal format. The .SYM file lists any user-defined symbols. 
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To invoke ASM-86, enter a command using the following form: 

ASMS6 source filename 1 $ optional parameters | 
Specifications for the optional parameters, which generally affect the assembly 
output, are described in the next section. The source file is specified using the 


following form: 


{d:}filename.{filetype} 


where 
d: is a valid drive letter specifying the source file’s location. Not 
needed if source is on current drive. 
filename is a valid CP/M filename of | to 8 characters. 
filetype is a valid file extension of 1 to 3 characters, usually .A86. 


The following are examples of valid ASM-86 commands: 


A>ASM86 В:ВІО588 
A>ASM86 BIOS88.A86 SFI АА HB PB SB 
А>АЅМ86 D: TEST 


Once invoked, ASM-86 responds with the message: 
CP/M 8086 ASSEMBLER VER х.х 
where x.x is the ASM-86 version number. ASM-86 then attempts to open the source 


file. If the file does not exist on the designated drive, or does not have the correct 
extension as described above, the assembler displays the message: 


NO FILE 


If an invalid parameter is given in the optional parameter list, ASM-86 displays the 
message: 


PARAMETER ERROR 


After opening the source file, the assembler creates the output files. Usually these 
files are located on the current disk drive, but they may be redirected using the 
optional parameters, or by a drive specification in the the source file name. In the 
latter case, ASM-56 directs the output files to the drive specified in the source file 
name. 


During assembly, ASM-86 aborts if an error condition such as a full disk or symbol 
table overflow is detected. When ASM-86 detects an error in the source file, it places 
an error message line in the listing file in front of the line containing the error. 


Each error message has a number and gives a brief explanation of the error. 
Appendix H lists ASM-86error messages. When the assembly is complete, ASM-86 
displays the message: 


END OF ASSEMBLY. NUMBER OF ERRORS: n 


OPTIONAL RUNTIME PARAMETERS 


The dollar sign character ($) introduces an optional string of runtime parameters in 
the command line. А parameter is a single letter that must be followed by another 
single letter argument indicating the device name specification. The parameters аге 
shown in Table 1-1. 


Table 1-1 Runtime Parameter Summary 


PARAMETER TO SPECIFY VALID ARGUMENTS 


source file device 


hex output file device 
list file device 

symbol file device 
format of hex output file 


All parameters are optional, and can be entered in the command line in any order. 
Enter the dollar sign only once at the beginning ofthe parameter string. Spaces may 
separate parameters, but are not required. No space is permitted, however, between 
a parameter and its device name. 


A device name must follow parameters A, H, P and S. Use the following device 
names: 


A, B, C, D or X, Y, Z 
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Introduction 


Device names A through D respectively specify disk drives A through D. X specifies 
the user console (CON:), Y specifies the line printer (LST:), and Z suppresses output 
(NUL:). 


If output is directed to the console, it may be temporarily stopped at any time by 
typing a CTRL-S. Restart the output by typing a second CTRL-S or any other 
character. 


The F parameter requires either ап I ora D argument. When 115 specified, ASM-86 
produces an object file in Intel hex format. A D argument requests Digital Research 
hex format. Appendix C discusses these formats in detail. If the F parameter is not 
entered in the command line, ASM-86 produces Digital Research hex format. 


The following table gives examples of valid ASM-86 command line entries. 


Table 1-2 Runtime Parameter Examples 


COMMAND LINE RESULT 


ASMS86 IO Assemble file IO. A86, produce IO.HEX, IO.LST 
and IO.SYM, all on the default drive. 


А5М86 ІО.АЅМ $ AD SZ | Assemble file IO.ASM on device D, produce 
IO.LST and IO.HEX, no symbol file. 


А5М86 IO 5 PY SX Assemble file IO. A86, produce IO.HEX, route list- 
ing directly to printer, output symbols on 
console. 


А5М86 IO 5 FD Produce Digital Research hex format. 


ASM86 IO $ FI Produce Intel hex format. 


ABORTING ASM-86 


You may abort ASM-86 execution at any time by pressing any key on the APC 
keyboard. When a key is pressed, ASM-86 responds with the question: 


USER BREAK. OK(Y/N)? 


Enter a Y to abort the assembly and return to the operating system. Enter N to 
continue the assembly. 
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Elements of ASM-86 Assembly 
Language 


ASM-86 CHARACTER SET 


ASM-86 recognizes a subset ofthe ASCII character set. The valid characters are the 
alphanumerics, special characters, and nonprinting characters shown below: 


ABCDEFGHIJKLMNOPQRS TUVWXYZ 


а Б с 4 е Ѓе Пр а | КІ ппоратв її ц у ух у 2 
О 1 2 3 4 5 6 7 8 9 | 
HO Soe жй ee у qne ыс же зн ај: 


space, tab, carriage return, and line feed 


Lowercase letters are treated as uppercase except within strings. Only alpha- 
numerics, special characters, and spaces may appear within a string. 


TOKENS AND SEPARATORS 


A token is the smallest meaningful unit of an ASM-86 source program, much as a 
word is the smallest meaningful unit of an English composition. Adjacent tokens 
are commonly separated by a blank character or space. Any sequence of spaces may 
appear wherever a single space is allowed. ASM-86 recognizes horizontal tabs as 
separators and interprets them as spaces. Tabs are expanded to spaces in the list file. 
The tab stops are at each eighth column. 


DELIMITERS 


Delimiters mark the end of a token and add special meaning to the instruction, as 
opposed to separators, which merely mark the end of a token. When a delimiter is 
present, separators need not be used. However, separators entered after delimiters 
can make your program easier to read. 


Table 2-1 describes ASM-86 separators and delimiters. Some delimiters are also 
operators and are explained in greater detail later in the chapter. 
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CHARACTER 


space 


tab 


carriage return 


line feed 


semicolon 


colon 


period 


dollar sign 


plus 


minus 


asterisk 


slash 
at sign 


underscore 


Table 2-1 Separators and Delimiters 


NAME 


separator 


legal in source files, expanded in 
list files 


terminate source lines 


legal after CR; if within source 
lines, it is interpreted as a space 


start comment field 


identifies a label, used in segment 
override specification 


forms variables from numbers 


notation for "present value of 
location pointer" 


arithmetic operator for addition 
arithmetic operator for subtrac- 
tion 


arithmetic operator for multipli- 
cation 


arithmetic operator for division 
legal in identifiers 


legal in identifiers 
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Table 2-1 Separators and Delimiters (cont'd) 


exclamation logically terminates a statement, 


point thus allowing multiple statements 
on a single source line 


apostrophe delimits string constants 


CONSTANTS 

А constant is a value known at assembly time that does not change while the 
assembled program is executed. A constant may be either an integer or a character 
string. 

Numeric Constants 


А numeric constant is a 16-bit value іп one of several bases. The base, called the 
radix of the constant, is identified by a radix indicator that follows the numeric 
constant. The radix indicators are shown in Table 2-2. 


Table 2-2 Radix Indicators for Constants 


INDICATOR CONSTANT TYPE BASE 


binary 2 
octal 8 
octal 8 
decimal 10 
hexadecimal 16 


ASM-86 assumes that any numeric constant not terminated with a radix indicator is 
a decimal constant. Radix indicators may be represented in either uppercase or 
lowercase. 


A constant is thus a sequence of digits followed by an optional radix indicator, 
where the digits are in the range allowed for the radix. Binary constants must be 
composed of 0s and 15. Octal digits range from 0 to 7; decimal digits range from 0 to 
9. Hexadecimal constants contain decimal digits as well as the hexadecimal digits A 
(10D), B (11D), C (12D), D (13D), E (14D), and F (15D). Note that the leading 
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character of a hexadecimal constant must be either a decimal digit so that ASM-86 
cannot confuse a hex constant with an identifier, or leading 0 to prevent this 
problem. The following are valid numeric constants: 


1234 1234D 1100B 1111000011110000B 
1234Н ОЕҒЕН 33770 137720 
33770 ОҒЕЗН 1234d Offffh 


Character Strings 


ASM-86 treats an ASCII character string delimited by apostrophes as a string 
constant. All instructions accept only one- or two-character constants as valid 
arguments. Instructions treat a one-character string as an 8-bit number. A two- 
character string is treated as a 16-bit number with the value ofthe second character 
in the low-order byte, and the value of the first character in the high-order byte. 


The numeric value of a character is its ASCII code. ASM-86 does not translate case 
within character strings, so both uppercase and lowercase letters can be used. Note 
that only alphanumerics, special characters, and spaces are allowed within strings. 


A DB assembler directive is the only ASM-86 statement that may contain strings 
longer than two characters. The string may not exceed 255 bytes. To include an 
apostrophe to be printed within the string, enter it twice. ASM-86 interprets the two 
keystrokes (7) as а single apostrophe. Table 2-3 shows valid strings and how they 
appear after processing. 


Table 2-3 String Constant Examples 


ENTERED AS: INTERPRETED AS 


„оо? 


а 
"АҺ "са 

Т like CP/M’ 
‘ONLY UPPER CASE' 
‘only lower case’ 


a 
Ab’Cd 
I like CP/M 


ONLY UPPER CASE 
only lower case 


IDENTIFIERS 


Identifiers are character sequences that have a special, symbolic meaning to the 
assembler. All identifiers in ASM-86 must obey the following rules: 
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е The first character must be alphabetic (A,...Z, а,...2). 


е Any subsequent characters can be either alphabetical or a numerical (0, 1... 
...9). ASM-86 ignores the special characters @ and —, but they are still legal. 
For example, a_b becomes ab. 


е Identifiers may be any length up to the limit of the physical line. 


Two types of identifiers can be used. The first are keywords, that have predefined 
meanings to the assembler. The second are symbols, that are defined by the user. 
The following are all valid identifiers: 


NOLIST 

WORD 

AH 

Third. street 
How_are_you_today 
variable@number@ 1234567890 


Keywords 


A keyword is an identifier that has a predefined meaning to the assembler. Key- 
words are reserved; the user cannot define an identifier identical to a keyword. Fora 
complete list of keywords, see Appendix D. 


ASM-86 recognizes five types of keywords: instructions, directives, operators, 
registers and predefined numbers. 8086 instruction mnemonic keywords and the 
actions they initiate are defined in Chapter 4. Directives are discussed in Chapter 3. 
Operators are described later in this chapter. Table 2-4 lists the ASM-86 keywords 
that identify 8086 registers. 


Three keywords are predefined numbers: BYTE, WORD, and DWORD. The 
values of these numbers are 1, 2 and 4, respectively. In addition, a Type attribute 1s 
associated with each of these numbers. Тһе Type attribute of the keyword 15 equal 
to the keyword’s numeric value. The next section provides a complete discussion of 
Type attributes. 
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Table 2-4 Register Keywords 


REGISTER NUMERIC 
SYMBOL SIZE VALUE MEANING 


Accumulator-High-Byte 
Base-Register-High-Byte 
Count-Register-High-Byte 
Data-Register-High-Byte 


Accumulator-Low-Byte 
Base-Register-Low-Byte 
Count-Register-Low-Byte 
Data-Register-Low-Byte 


Accumulator (full word) 
Base-Register ý 
Count-Register 
Data-Register 


Base Pointer 
Stack Pointer 
Source Index 
Destination Index 


Code-Segment-Register 
Data-Segment-Register 
Stack-Segment-Register 
Extra-Segment-Register 


Symbols and Their Attributes 


A symbol is a user-defined identifier with attributes that specify what kind of 
information the symbol represents. Symbols fall into three categories: 


€ variables 

ө labels 

€ numbers 
Variables identify data stored at a particular location in memory. АП variables have 
the following three attributes: 
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е Segment — tells which segment was being assembled when the variable was 
defined. 


е Offset — tells how many bytes there are between the beginning of the 
segment and the location of this variable. 


ө Type — tells how many bytes of data are manipulated when this variable is 
referenced. 


A Segment may be a code-segment, a data-segment, a stack-segment or an extra- 
segment depending on its contents and the register that contains its starting address 
(see Chapter 3). A segment may start at any address divisible by 16. ASM-86 uses 
this boundary value as the Segment portion of the variable's definition. 


The Offset of a variable may be any number between 0 and OFFFFH (65535D). A 
variable must have one of the following Type attributes: 


e BYTE 
е WORD 
ө DWORD 


BYTE specifies a one-byte variable, WORD a two-byte variable and DWORD a 
four-byte variable. The DB, DW, and DD directives respectively define variables as 
these three types (see Chapter 3). For example, a variable is defined when it appears 
as the name for a storage directive: 


VARIABLE DB 0 


A variable may also be defined as the name in an EQU directive referencing another 
label, as shown below: 


VARIABLE EQU ANOTHER VARIABLE 


Labels identify locations in memory that contain instruction statements. They are 
referenced with jumps or calls. All labels have two attributes: 


e Segment 
е Offset 


2-7 


Elements of ASM-86 Assembly Language 


2-8 


Label segment and offset attributes are essentially the same as variable segment and 
offset attributes. Generally, a label is defined when it precedes an instruction. A 
colon (:) separates the label from the instruction, as shown inthe following example: 


LABEL: ADD AX,BX 


A label may also appear as the name in an EQU directive referencing another label, 
as shown in the following example: 


LABEL EQU ANOTHER LABEL 


Numbers may also be defined as symbols. A number symbol is treated as if you had 
explicitly coded the number it represents. For example: 


Number.five EQU 5 
MOV AL, Number. five 


is equivalent to: 
MOV AL,5 


The following section describes operators and their effects on numbers and number 
symbols. 


OPERATORS 
ASM-86 operators fall into the following categories: 


arithmetic 

logical 

relational 

segment override 

variable manipulators and creators. 


Table 2-5 defines ASM-86 operators. In this table, a and b represent two elements of 
the expression. The validity column defines the type of operands the operator can 
manipulate, with the bar character | indicating alternatives. 


( ) 
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Table 2-5 ASM-86 Operators 


SYNTAX RESULT VALIDITY 
Logical Operators 


bit-by-bit logical EXCLUSIVE a, b = number 
OR of a and b. 


bit-by-bit logical OR of a 
and b. 


a, b = number 


bit-by-bit logical AND of a 
and b. 


a, b = number 


logical inverse of a: all 0% a — 16-bit number 


become 1%, l's become 0%. 


Relational Operators | 


a EQb returns OFFFFH if a= b, a,b= 
otherwise 0. unsigned number 


returns OFFFFH if a < b, 
otherwise 0. 


а, b= 
unsigned number 


а, b= 
unsigned number 


returns OFFFFH if a <= b, 
otherwise 0. 


returns OFFFFH if a > Б, 
otherwise 0. 


a, Б = 
unsigned number 


returns OFFFFH if >= b, 
otherwise 0. 


а, b= 
unsigned number 


returns OFFFFH if a >< Б, 
otherwise 0. 


а, b= 
unsigned number 
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Table 2-5 ASM-86 Operators (cont'd) 


SYNTAX RESULT VALIDITY 
Arithmetic Operators 


arithmetic sum of a and b. a — variable, 
label or number 
b = number 


arithmetic difference of a — variable, 
a and b. label or number 
|» b= number 


does unsigned multiplication a, b = number 
of a and b. 


does unsigned division of a a, b = number 
and b. 


returns remainder of a / b. a, b = number 
returns the value which a, b = number 
results from shifting a to 

left by an amount b. 

returns the value which a, b = number 
results from shifting a to 

the right by an amount b. 


gives a. a — number 


gives 0-а. a — number 


Segment Override 


seg reg: overrides assembler's choice < seg reg >= 
addr exp of segment register. CS, DS, SS 


or ES 
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Table 2-5 ASM-86 Operators (cont'd) 


SYNTAX RESULT VALIDITY 
Variable Manipulators, Creators 


a = label | 
variable 


creates a number whose value 
is the segment value of the 
variable or label a. 


a = label | 
variable 


creates a number whose value 
is the offset value of the 
variable or label a. 


OFFSET a 


a =label | 
variable 


creates a number. If the 
variable a is of type BYTE, 
WORD or DWORD, the value of 
the number will be 1, 2 or 4, 
respectively. 


a = label | 
variable 


creates a number whose value 
is the LENGTH attribute of 
the variable a. The length 
attribute is the number of 
bytes associated with the 
variable. 


LENGTH a 


if LENGTH a > 0, then LAST а = 
LENGTH а - 1; if LENGTH a= 
0, then LAST a = 0. 


a = label | 
variable 


creates virtual variable or 
label with type of a and 
attributes of b 


a = BYTE | 
WORD,| DWORD 
b = «addr exp» 


creates variable with an a = number 
offset attribute of a. 
Segment attribute is current 


segment. 
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Table 2-5 ASM-86 Operators (cont'd) 


RESULT VALIDITY 


Arithmetic Operators 
no argument 


SYNTAX 


creates label with offset 
equal to current value of 
location counter; segment 
attribute is current segment. 


Operator Examples 


Logical operators perform the Boolean logic operations AND, OR, XOR, and 
NOT, accepting only numbers as operands. For example: 


00FC MASK EQU ОЕСН 

0080 SIGNBIT EQU 80H 

0000 B180 MOV CL,MASK AND SIGNBIT 
0002 B003 MOV AL,NOT MASK 


Relational operators treat all operands as unsigned numbers. The relational opera- 
tors are EQ (equal), LT (less than), LE (less than or equal), GT (greater than), GE 
(greater than or equal), and NE (not equal). Each operator compares two operands 
and returns all ones (QFFFFH) if the specified relation is true and all zeros if it is 
not. For example: 


000A LIMITI EQU 10 
0019 LIMIT2 EQU 25 
0004 BBFFFF  — MOV  AXLIMITI LT LIMIT2 
0007 B80000 MOV AX,LIMIT1 GT LIMIT2 


Addition and subtraction operators compute the arithmetic sum and difference of 
two operands. The first operand may be a variable, label, or number, but the second 
operand must be a number. When a number is added to a variable or label, the result 
is a variable or label whose offset is the numeric value ofthe second operand plus the 
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offset ofthe first operand. Subtraction from a variable or label returns a variable or 
label whose offset is that of first operand decremented by the number specified in 
the second operand. For example: 


0002 COUNT EQU 2 

0005 DISPI EQU 5 

000A FF FLAG DB OFFH 

000В 2ЕА00В00 МОУ AL,FLAG+t+1 

000F 2Е8А0Е0Ғ00 МОУ CL,FLAG-DISPI 
0014 B303 MOV BL,DISP1-COUNT 


The multiplication and division operators *, /, MOD, SHL, and SHR accept only 
numbers as operands. The operators, * and /, treat all operators as unsigned 
numbers. For example: 


0016 ВЕ5500 MOV S1,256/3 
0019 B310 MOV BL,64/4 
0050 BUFFERSIZE EQU 80 
001B B8A000 MOV AX,BUFFERSIZE * 2 


Unary operators accept both signed and unsigned operators as shown below: 


001E B123 MOV CL,+35 
0020 В007 МОУ AL,2--5 
0022 B2F4 MOV DL,-12 


When manipulating variables, the assembler decides which segment register to use. 

You may override the assembler’s choice by specifying a different register with the 

segment override operator. The syntax for the override operator is as follows: 
segment register:address expression 


where the segment register is CS, DS, SS, or ES. For example: 


0024 3688B472D MOV AX,SS:WORDBUFFER[BX] 
0028 268В0Е5В00 MOV CX,ES: ARRAY 
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A variable manipulator creates a number equal to one attribute of its variable 
operand. SEG extracts the variable's segment value, OFFSET its offset value, 
ТҮРЕ its type value (1, 2, or 4), and LENGTH the number of bytes associated with 
the variable. LAST compares the variable's LENGTH with 0 and if greater, then 
decrements LENGTH by one. If LENGTH equals 0, LAST leaves it unchanged. 
Variable manipulators accept only variables as operators. For example: 


002D 000000000000 WORDBUFFER DW 0,0,0 


0033 0102030405 BUFFER DB 1,2,3,4,5 

0038 В80500 | MOV AX,LENGTH BUFFER 
0038 B80400 MOV AX,LAST BUFFER 

003E B80100 MOV AX,TYPE BUFFER 

0041 B80200 MOV AX,TYPE WORDBUFFER 


The PTR operator creates a virtual variable or label, that is, one valid only during 
the execution of the instruction. PTR makes no changes to either of its operands. 
The temporary symbol has the same Type attribute as the left operator, and all 
other attributes of the right operator as shown below. 


0044 C60705 MOV BYTE PTR [BX], 5 
0047 8A07 MOV AL,BYTE PTR [BX] 
0049 FF04 INC WORD PTR [SI] 


The Period operator (.) creates a variable in the current data segment. The new 
variable has a segment attribute equal to the current data segment and an offset 
attribute equal to its operand. Its operand must be a number. For example: 


0048 A10000 MOV AX, .0 
004E 268B1E0040 MOV BX, ES: .4000H 


The Dollar sign operator ($) creates a label with an offset attribute equal to the 
current value of the location counter. The label's segment value is the same as the 
current code segment. This operator takes no operand. For example: 


0053 E9FDFF JMP $ 
0056 EBFE JMPS % 
0058 E9FD2F JMP $+3000H 
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Operator Precedence 


Expressions combine variables, labels or numbers with operators. ASM-86 allows 
several kinds of expressions (discussed in the next section). If more than one 
operator appears in an expression, the operations they perform occur in a specific 
order of precedence. 


In general, ASM-86 evaluates expressions left to right, but operators with higher 
precedence are evaluated before operators with lower precedence. When two opera- 
tors have equal precedence, the leftmost is evaluated first. Table 2-6 presents 
ASM-86 operators in order of increasing precedence. 


Parentheses can override normal rules of precedence. The part of an expression 
enclosed in parentheses is evaluated first. If parentheses are nested, the innermost 
expressions are evaluated first. However, only five levels of nested parentheses are 
legal. For example: 


15/3 + 18/9=5+2=7 
15/(3 + 18/9) = 15/(3 + 2) = 15/5 23 


Table 2-6 Precedence of Operations in ASM-86 


ORDER OPERATOR TYPE | OPERATORS 


XOR, OR 


Logical 


AND 


Logical 


Logical NOT 


EQ, LT, LE, GT, 
GE, NE 


Relational 


Addition/subtraction +,- 


ж /, MOD, SHL, 
SHR 


Multiplication/division 


+,- 


Unary 


Segment override < segment override>: 
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Table 2-6 Precedence of Operations in ASM-86 (cont'd) 


ORDER OPERATOR TYPE OPERATORS 


Variable manipulators, SEG, OFFSET, PTR, 
creators TYPE, LENGTH, LAST 


Parentheses/brackets (), ГЈ 


Period and Dollar 49 


EXPRESSIONS 


ASM-86 allows address, numeric, and bracketed expressions. An address expres- 
sion evaluates to a memory address and has three components: 


€ asegment value 
€ an offset value 
е atype 


Both variables and labels are address expressions. An address expression is not a 
number, but its components are. Numbers may be combined with operators such as 
PTR to make an address expression. 


A numeric expression evaluates to a number. It does not contain any variables or 
labels, only numbers and operands. 


Bracketed expressions specify base- and index-addressing modes. The base registers 
are BX and BP, and the index registers are DI and SI. A bracketed expression may 
consist of a base register, an index register, or both a base register and an index 
register. 


Use the + operator between a base register and an index register to specify both 
base- and index-register addressing. For example: | 


MOV variable[bx],0 


MOV AX,[BX-*DI] 
MOV AX,SI] 
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STATEMENTS 


Just as tokens in the ASM-86 assembly language correspond to words in English, so 
are statements analogous to sentences. A statement tells ASM-86 what action to 
perform. Two types of statements are used: instructions and directives. Instructions 
are translated by the assembler into 8086 machine language instructions. Directives 
are not translated into machine code but instead direct the assembler to perform 
certain clerical functions. 


Terminate each assembly language statement with a carriage return (CR) and line 
feed (LF), or with an exclamation point (!), which ASM-86treats as an end-of-line. 
Multiple assembly language statements can be written on the same physical line if 
separated by exclamation points. 


The AS instruction set is defined in Chapter 4. The following is the syntax for an 
instruction statement. 


(label: {prefix} mnemonic {operand(s)} {;comment} 
where the fields are defined as follows: 


label: A symbol followed by ":" defines a label at the current 
value of the location counter in the current segment. This 
field is optional. 


prefix Certain machine instructions such as LOCK and REP 
may prefix other instructions. This field is optional. 


mnemonic A symbol defined as a machine instruction, either by the 
assembler or by an EQU directive. This field is optional 
unless preceded by a prefix instruction. If it is omitted, no 
operands may be present, although the other fields may 
appear. ASM-86 mnemonics are defined in Chapter 4. 


operand(s) An instruction mnemonic may require other symbols to 
represent operands to the instruction. Instructions may 
have zero, one or two operands. 


comment Any semicolon (;) appearing outside a character string 
begins a comment, which is ended by a carriage return. 
Comments improve the readability of programs. This 
field is optional. 
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ASM-86 directives are described in Chapter 3. The following is the syntax for а 
directive statement: 


{name} directive operand(s) {;comment} 
where the fields are defined as follows: 
name Unlike the label field of an instruction, the name field of a 
directive is never terminated with a colon. Directive 


names are legal for only DB, DW, DD, RS and EQU. For 
DB, DW, DD and RS the name is optional; for EQU it is 


required. 
directive One of the directive keywords defined in Chapter 3. 
operand(s) Analogous to the operands to the instruction mnemon- 


ics. Some directives, such as DB, DW, and DD, allow any 
operand while others have special requirements. 


comment Exactly as defined for instruction statements. 


Chapter 3 
Assembler Directives 


INTRODUCTION 


Directive statements cause ASM-86 to perform housekeeping functions such as 
assigning portions of code to logical segments, requesting conditional assembly, 
defining data items, and specifying listing file format. General syntax for directive 
statements appears in Chapter 2. 


In the sections that follow, the specific syntax for each directive statement is given 
under the heading and before the explanation. These syntax lines use special 
symbols to represent possible arguments and other alternatives. Brackets, { |, 
enclose optional arguments. Angle brackets, < >, enclose descriptions of user- 
supplied arguments. Do not include these symbols when coding a directive. 


SEGMENT START DIRECTIVES 


At runtime, every 8086 memory reference must have a 16-bit segment base value 
and a 16-bit offset value. These are combined to produce the 20-bit effective address 
needed by the CPU to physically address the location. The 16-bit segment base 
value or boundary is contained in one of the segment registers CS, DS, SS, or ES. 
The offset value gives the offset of the memory reference from the segment bound- 
ary. A 16-byte physical segment is the smallest relocatable unit of memory. 


ASM-86 predefines four logical segments: the Code Segment, Data Segment, Stack 
Segment, and Extra Segment, which are respectively addressed by the CS, DS, SS, 
and ES registers. Future versions of ASM-86 will support additional segments such 
as multiple data or code segments. All ASM-86statements must be assigned to one 
ofthe four currently supported segments so that they can be referenced by the CPU. 
A segment directive statement, CSEG, DSEG, SSEG, or ESEG, specifies that the 
statements following it belong to a specific segment. The statements are then 
addressed by the corresponding segment register. ASM-86 assigns statements to the 
specified segment until it encounters another segment directive. 
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Instruction statements must be assigned to the Code Segment. Directive statements 
may be assigned to any segment. ASM-86 uses these assignments to change from 
one segment register to another. For example, when an instruction accesses a 
memory variable, ASM-86 must know which segment contains the variable so it can 
generate a segment override prefix byte if necessary. 


The CSEG Directive 


CSEG «numeric expression? 
CSEG 
CSEG $ 


This directive tells the assembler that the following statements belong in the Code 
Segment. АП instruction statements must be assigned to the Code Segment. АП 
directive statements are legal within the Code Segment. 


Use the first form when the location of the segment is known at assembly time; the 
code generated is not relocatable. Use the second form when the segment location is 
not known at assembly time; the code generated is relocatable. Use the third form to 
continue the Code Segment after it has been interrupted by a DSEG, SSEG, or 
ESEG directive. The continuing Code Segment starts with the same attributes, such 


as location and instruction pointer, as the previous Code Segment. 


The DSEG Directive 
DSEG «numeric expression? 
DSEG 
DSEG $ 


This directive specifies that the following statements belong to the Data Segment. 
The Data Segment primarily contains the data allocation directives DB, DW, DD 
and RS, but all other directive statements are also legal. Instruction statements are 
illegal in the Data Segment. 


Use the first form when the location of the segment is known at assembly time; the 
code generated is not relocatable. Use the second form when the segment location is 
not known at assembly time; the code generated is relocatable. Use the third form to 
continue the Data Segment after it has been interrupted by a CSEG, SSEG, or 
ESEG directive. The continuing Data Segment starts with the same attributes as the- 
previous Data Segment. 


Тһе SSEG Directive 
SSEG «numeric expression? 
SSEG 
SSEG $ 


The SSEG directive indicates the beginning of source lines for the Stack Segment. 
Use the Stack Segment for all stack operations. All directive statements are legal in 
the Stack Segment, but instruction statements are illegal. 


Use the first form when the location of the segment is known at assembly time; the 
code generated is not relocatable. Use the second form when the segment location is 
not known at assembly time; the code generated is relocatable. Use the third form to 
continue the Stack Segment after it has been interrupted by a CSEG, DSEG, or 
ESEG directive. The continuing Stack Segment starts with the same attributes as 
the previous Stack Segment. 


The ESEG Directive 


ESEG «numeric expression? 
ESEG 
ESEG $ 


This directive initiates the Extra Segment. All directive statements are legal in the 
Extra Segment, but instruction statements are illegal. 


Use the first form when the location of the segment is known at assembly time; the 
code generated is not relocatable. Use the second form when the segment location is 
not known at assembly time; the code generated is relocatable. Use the third form to 
continue the Extra Segment after it has been interrupted by a DSEG, SSEG, or 
CSEG directive. The continuing Extra Segment starts with the same attributes as 
the previous Extra Segment. 


THE ORG DIRECTIVE 
ORG <numeric expression> 
The ORG directive sets the offset of the location counter in the current segment to 


the value specified in the numeric expression. Define all elements of the expression 
before the ORG directive to avoid ambiguity in forward references. 
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In most segments, an ORG directive is unnecessary. If no ORG is included before 
the first instruction or data byte in a segment, assembly begins at location zero 
relative to the beginning of the segment. А segment can have any number of ORG 
directives. 


THE IF AND ENDIF DIRECTIVES 


IF «numeric expression? 
«source line 1» 
«source line 2» 


«source line n» 
ENDIF 


The IF and ENDIF directives allow a group of source lines to be conditionally 
included or excluded from the assembly. Use conditional directives to assemble 
several different versions of a single source program. 


When the assembler finds an IF directive, it evaluates the numeric expression 
following the IF keyword. If the expression evaluates to a nonzero value, then 
<source line 1> through <source line n> are assembled. If the expression evaluates to 
zero, then all lines are listed but not assembled. All elements in the numeric 
expression must be defined before they appear in the IF directive. Nested IF 
directives are not legal. 


THE INCLUDE DIRECTIVE 


INCLUDE <filename> 


This directive includes another ASM-86 file in the source text. For example, the 
directive: 


INCLUDE EQUALS.A86 


instructs the assembler to insert into the source text the file named EQUALS.A86. 
Use INCLUDE when the source program resides in several different files. 
INCLUDE directives may not be nested; a source file called by an INCLUDE 
directive may not contain another INCLUDE statement. If <filename> does not 


Assembler Directives 


contain a file type, the file type is assumed to Бе. A86. If no drive name is specified 
with «filename», ASM-86 assumes the drive containing the source file. 


THE END DIRECTIVE 
END 


An END directive marks the end of a source file. Any subsequent lines are ignored 


by the assembler. END is optional. If not present, ASM-86 processes the source 
until it finds an end-of-file character (LAH). 


THE EQU DIRECTIVE 


symbol EQU «numeric expression? 
symbol EQU «address expression» 
symbol EQU «register? 

symbol EQU «instruction mnemonic> 


The EQU (equate) directive assigns values and attributes to user-defined symbols. 
The required symbol name may not be terminated with a colon. The symbol cannot 
be redefined by a subsequent EQU or another directive. Any elements used in 
numeric or address expressions must be defined before the EQU directive appears. 


The first form assigns a numeric value to the symbol; the second assigns a memory 
address. The third form assigns a new name to an 8086 register. The fourth form 
defines a new instruction subset. The following are examples of these four forms: 


0005 FIVE БОО 2941 
0033 NEXT EQU BUFFER 
0001 COUNTER EQU CX 


MOVVV EQU MOV 


005D 8BC3 MOVVV AX,BX 


THE DB DIRECTIVE 


{symbol} DB «numeric expression? ( , «numeric expression? .. ) 
{symbol} DB «string constant? {string constant? ... | 
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The DB directive defines initialized storage areas in byte format. Numeric expres- 
sions are evaluated to 8-bit values and sequentially placed in the hex output file. 
String constants are placed in the output file according to the rules defined in 
Chapter 2. A DB directive is the only ASM-86 statement that accepts a string 
constant longer than two bytes. There is no translation from lowercase to uppercase 
within strings. Multiple expressions or constants, separated by commas, may be 
added to the definition, but may not exceed the physical line length. 


Use an optional symbol to reference the defined data area throughout the program. 
The symbol has four attributes: the Segment and Offset attributes determine the 
symbol's memory reference, the Type attribute specifies single bytes, and Length 
tells the number of bytes (allocation units) reserved. 


The following statements show DB directives with symbols: 


005F 43502F4D2073 ТЕХТ рв ‘CP/M system',0 


797374656D00 
006B El AA DB ‘a’ + 80H 
006C 0102030405 X DB 1234,5 
0071 B90C00 MOV CX, LENGTH TEXT 


THE DW DIRECTIVE 


{symbol} DW «numeric expression? {, «numeric expression? .. } 
{symbol} DW «string constant» { , «string constant? ... | 


The DW directive initializes two-byte words of storage. String constants longer 
than two characters are illegal. Otherwise, DW uses the same procedure to initialize 
storage as DB. The following are examples of DW statements: 


0074 0000 CNTR DW 0 
0076 63C166C169C1  JMPTAB DW SUBR1,SUBR2,SUBR3 
007C 010002000300 DW 1,2,3,4,5,6 
040005000600 
THE DD DIRECTIVE 


{symbol} DD «numeric expression? { , «numeric expression? .. } 
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The DD directive initializes four bytes of storage. The Offset attribute of the 
address expression is stored in thetwo lower bytes, the Segment attribute in thetwo 
upper bytes. Otherwise, DD follows the same procedure as DB. The following are 
examples of DD statements: 


1234 CSEG 1234H 


0000 6ССІЗ4126ЕСІ LONG-JMPTAB DD ROUTI,ROUT2 


3412 
0008 72С1341275СІ DD ROUT3,ROUT4 
3412 
THE RS DIRECTIVE 


{symbol} RS <numeric expression> 


The RS directive allocates storage in memory but does not initialize it. The numeric 
expression gives the number of bytes to be reserved. An RS statement does not give 
a byte attribute to the optional symbol. The following example shows the RS 
statement: 


0010 BUF RS 80 
0060 RS 4000H 
4060 RS 1 


THE RB DIRECTIVE 
{symbol} RB «numeric expression? 


The RB directive allocates byte storage in memory without any initialization. This 
directive is identical to the RS directive except that it does give the byte attribute. 


THE RW DIRECTIVE 
{symbol} RW «numeric expression? 
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The RW directive allocates two-byte word storage in memory but does not initialize 
it. The numericexpression gives the number of words to be reserved. The following 
example shows the RW statement: 


4061 BUFF RW 128 
4161 RW 4000H 
C161 RW 1 


THE TITLE DIRECTIVE 
TITLE «string constant? 


ASM-86 prints the string constant defined by a TITLE directive statement at the top 
of each printout page in the listing file. The title character string should not exceed 
30 characters. The following example shows the TITLE statement: 


TITLE 'CP/M monitor 


THE PAGESIZE DIRECTIVE 
PAGESIZE «numeric expression? 


The PAGESIZE directive defines the number of lines to be included on each 
printout page. The default page size is 66. 


THE PAGEWIDTH DIRECTIVE 
PAGEWIDTH «numeric expression? 


The PAGEWIDTH directive defines the number of columns printed across the 
page when the listing file is output. The default page width is 120 columns unless the 
listing is routed directly to the terminal; then the default page width is 79 columns. 


THE EJECT DIRECTIVE 


EJECT 


The EJECT directive performs a page eject during printout. The EJECT directive 
itself is printed on the first line of the next page. 


THE SIMFORM DIRECTIVE 
SIMFORM 


The SIMFORM directive replaces a form feed (FF) character in the print file with 
the correct number of line feeds (LF). Use this directive when printing on a printer 
unable to interpret the form feed character. 


THE NOLIST AND LIST DIRECTIVE 


NOLIST 
LIST 


The NOLIST directive blocks the printout of lines following the directive. Restart 
the listing with a LIST directive. 
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Chapter 4 
Тһе ASM-86 Instruction Set 


INTRODUCTION 


The ASM-86 instruction set includes all 8086 machine instructions. The general 
syntax for instruction statements is given in Chapter 2. The following sections 
define the specific syntax and required operand types for each instruction, without 
reference to labels or comments. The instruction definitions are presented in tables 
for easy reference. For a more detailed description of each instruction, see Intel's 
MCS-86 Assembly Language Reference Manual. For descriptions of the instruction 
bit patterns and operations, see Intel's MCS-86 User's Manual. 


The instruction definition tables present ASM-86 instruction statements as combi- 
nations of mnemonics and operands. А mnemonic is a symbolic representation for 
an instruction, and its operands are its required parameters. Instructions can take 
. zero, one or two operands. When two operands are specified, the left operand is the 
instruction's destination operand, with two operands separated by a comma. 


The instruction definition tables organize ASM-86 instructions into functional 
groups. Within each table, the instructions are listed alphabetically. Table 4-1 
shows the symbols used in the instruction definition tables to define operand types. 


Table 4-1 Operand Type Symbols 


OPERAND TYPE 


any NUMERIC expression 


any NUMERIC expression which evaluates to an 8-bit 
number 


accumulator register, AX or AL 


any general purpose register, not segment register 
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Table 4-1 Operand Type Symbols (cont'd) 


SYMBOL OPERAND TYPE 


regl6 a 16-bit general purpose register, not segment register 
segreg any segment register: CS, DS, SS, or ES 


mem |. any ADDRESS expression, with or without base- 
and/or index-addressing modes, such as: 


variable 
variable+3 
variable[bx] 
variable[SI] 
variable BX-- SI] 
[BX] 

[BP- DI] 


simpmem any ADDRESS expression WITHOUT base- and 
index- addressing modes, such as: 


variable 
variable+4 


mem] reg any expression symbolized by "reg" or "mem" 


meml|regl6 any expression symbolized by "mem reg", but must be 
16 bits 


label any ADDRESS expression which evaluates to a label 


lab8 any "label" which is within +128 bytes distance from 
the instruction 


The 8086 CPU has nine single-bit flag registers which reflect the state of the CPU. 
The user cannot access these registers directly, but can test them to determine the 
effects of an executed instruction on an operand or register. The effects of instruc- 
tions on flag registers are also described in the instruction definition tables, using 
the symbols shown in Table 4-2 to represent the nine flag registers. 
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Table 4-2 Flag Register Symbols 


Auxiliary-Carry-Flag 
Carry-Flag 


Direction-Flag 


Interrupt-Enable-Flag 


Overflow-Flag 
Parity-Flag 
Sign-Flag 
Trap-Flag 


Zero-Flag 


DATA TRANSFER INSTRUCTIONS 


There are four classes of data transfer operations: general purpose, accumulator 
specific, address-object and flag. Only SAHF and POPF affect flag settings. Note in 
Table 4-3 that if acc=AL, a byte is transferred, but if acc=AX, a word is transferred. 


Table 4-3 Data Transfer Instructions 


ШЕ SYNTAX RESULT 


acc,numb8|numbl6 | transfer data from input port given by numb8 
ог numbl6 (0-255) to accumulator 


acc,DX transfer data from input port given by DX 
register (0-0FFFFH) to accumulator 


transfer flags to the AH register 
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Table 4-3 Data Transfer Instructions (cont'd) 


SYNTAX RESULT 


LDS гер16,тет transfer the segment part of the memory 
address (DWORD variable) to the DS seg- 
ment register, transfer the offset part to a 
general purpose 16-bit register 


LEA reg16,mem transfer the offset of the memory address to a 
(16-bit) register 


LES reg16,mem transfer the segment part of the memory 
address to the ES segment register, transfer 
the offset part to a 16-bit general purpose 
register 


MOV  reg,memlreg move memory or register to register 


MOV  memlreg,reg move register to memory or register 


MOV  memlreg,numb move immediate data to memory or register 
MOV вергер,тетігер16 move memory or register to segment register 
MOV  memlregló,segreg move segment register to memory or register 


OUT numb&numbl6,acc | transfer data from accumulator to output 
port (0-255) given by numb8 or numbl6 


OUT  DX,acc transfer data from accumulator to output port 
(0-0FFFFH) given by DX register 


POP mem] reg16 move top stack element to memory or register 


POP segreg move top stack element to segment register; note 
that CS segment register not allowed 


POPF transfer top stack element to flags 
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Table 4-3 Data Transfer Instructions (cont'd) 


SYNTAX RESULT 


mem|reg16 


segreg 


reg,mem| reg 
mem] reg,reg 


memlreg 


move memory or register to top stack element 


move segment register to top stack element 


transfer flags to top stack element 


transfer the AH register to flags 

exchange register and memory or register 
exchange memory or register and register 
perform table lookup translation, table given by 


"mem reg", which is always BX. Replaces AL 
with AL offset from BX. 


ARITHMETIC, LOGICAL, AND SHIFT INSTRUCTIONS 


The 8086 CPU performs the four basic mathematical operations in several different 
ways. It supports both 8-bit and 16-bit operations as well as signed and unsigned 


arithmetic. 


Six of the nine flag bits are set or cleared by most arithmetic operations to reflect the 
result of the operation. Table 4-4 summarizes the effects of arithmetic instructions 
on flag bits. Table 4-5 defines arithmetic instructions. Table 4-6 defines logical and 


shift instructions. 


Table 4-4 Effects of Arithmetic Instructions on Flags 


FLAG EFFECT 


is sct if the operation resulted in a carry out of(from addition) 


or a borrow into (from subtraction) the high-order bit of the 
result; otherwise CF is cleared. 
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Table 4-4 Effects of Arithmetic Instructions on Flags (cont'd) 


Is set if the operation resulted in a carry out of (from addition) 
or a borrow into (from subtraction) the low-order four bits of 
the result; otherwise AF is cleared. 


is set if the result of the operation is zero; otherwise ZF is 
cleared. 


is set if the result is negative. 
is set if the modulo 2 sum of the low-order eight bits of the 
result of the operation is 0 (even parity); otherwise PF is 


cleared (odd parity). 


is set if the operation resulted in an overflow; the size of the 
result exceeded the capacity of its destination. 


Table 4-5 Arithmetic Instructions 


SYNTAX RESULT 


adjust unpacked BCD (ASCII) for addition - 
adjusts AL 


adjust unpacked BCD (ASCII) for division - 
adjusts AL 


adjust unpacked BCD (ASCII) for multiplication 
- adjusts AX 


adjust unpacked BCD (ASCII) for subtraction 
- adjusts AL 


тер,тетігер add (with carry) memory or register to register 


теті гер,гер add (with carry) register to memory or register 
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Table 4-5 Arithmetic Instructions (cont'd) 


SYNTAX RESULT 


mem|reg,numb 


reg,memlreg 
теті гес,гер 


memlreg,numb 


reg,mem|reg 


теті гер,гер, 


mem|reg,numb 


memlreg 
memlreg 


memlreg 


memlreg 


add (with carry) immediate data to memory or 
register 


add memory or register to register 
add register to memory or register 
add immediate data to memory or register 


convert byte in AL to word in AH by sign exten- 
sion 


convert word in AX to double word in DX/AX 
by sign extension 


compare register with memory or register 
compare memory or register with register 
compare data constant with memory or register 
decimal adjust for addition - adjusts AL 
decimal adjust for subtraction - adjusts AL 
subtract 1 from memory or register 

add | to memory or register 

divide (unsigned) accumulator (AX or AL) by 
memory or register. If byte results, AL = quo- 
tient, AH = remainder. If word results, AX = 
quotient, DX = remainder 

divide (signed) accumulator (AX or AL) by 


memory or register - quotient and remainder 
stored as in DIV 
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Table 4-5 Arithmetic Instructions (cont'd) 


SYNTAX RESULT 


IMUL memlreg multiply (signed) memory or register by accumu- 
lator (AX or AL) - if byte, results in AH, AL. If 
word, results in DX, AX 


memlreg multiply (unsigned) memory or register by accumu- 
lator (AX or AL) - results stored as in IMUL 


memlreg two's complement memory or register 


reg,memlreg subtract (with borrow) memory or register from 
register 


meml|reg,reg subtract (with borrow) register from memory or 
register 


mem|reg,numb | subtract (with borrow) immediate data from 
memory or register 


гер,теті гер subtract memory or register from register 


memlreg,reg subtract register from memory or register 


mem|reg,numb | subtract data constant from memory or register 


Table 4-6 Logic and Shift Instructions 


SYNTAX RESULT 


тер,тетігер perform bitwise logical "and" of a register апа 
memory register 


memlreg,reg perform bitwise logical "and" of memory register 


and register 


mem|reg,numb | perform bitwise logical "and" of memory register 


and data constant 
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Table 4-6 Logic and Shift Instructions (cont'd) 


SYNTAX RESULT 


memlreg 


reg,mem|reg 


memlreg,reg 


memlreg,numb 


тетігер,1 


теті гер, СІ, 


тетігер,1 


теті гер, СІ, 


теті гер,1 


тетігер, СІ. 


теті гер,1 


тетпігер, СІ. 


тетпі|гер,1 


form ones complement of memory or register 


perform bitwise logical "or" of a register and 
memory register 


perform bitwise logical "or" of memory register 
and register 


perform bitwise logical "or" of memory register 
and data constant 


rotate memory or register 1 bit left through carry 
flag 


rotate memory or register left through carry flag, 
number of bits given by CL register 


rotate memory or register 1 bit right through 
carry flag 


rotate memory or register right through carry 
flag, number of bits given by CL register 


rotate memory or register 1 bit left 


rotate memory or register left, number of bits 
given by CL register 


rotate memory or register 1 bit right 


rotate memory or register right, number of bits 
given by CL register 


shift memory or register 1 bit left, shift in low- 
order zero bits 


4-9 


Тһе ASM-86 Instruction Set 


Table 4-6 Logic and Shift Instructions (cont'd) 


SYNTAX RESULT 


memlreg,CL shift memory or register left, number of bits given 
by CL register, shift in low-order zero bits 


memlreg,1 shift memory or register 1 bit right, shift in high- 
order bits equal to the original high-order bit 


теті гер, СІ, shift memory or register right, number of bits 
given by CL register, shift in high-order bits equal 
to the original high-order bit 


memlreg,1 shift memory or register 1 bit left, shift in low- 
order zero bits - note that SHL is a different 
mnemonic for SAL 


memlreg,CL shift memory or register left, number of bits given 
by CL register, shift in low-order zero bits - note 
that SHL is a different mnemonic for SAL 


memlreg,1 shift memory or register 1 bit right, shift in high- 
order zero bits 


memlreg,CL shift memory or register right, number of bits 
given by CL register, shift in high-order zero bits 


reg,memlreg perform bitwise logical "and" of a register and 
memory or register - set condition flags but do 
not change destination 


memlreg,reg perform bitwise logical "and" of memory register 
and register - set condition flags but do not 
change destination 


memlreg,numb | perform bitwise logical "and" - test of memory 
register and data constant - set condition flags but 
do not change destination 
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Table 4-6 Logic and Shift Instructions (cont'd) 


SYNTAX 


XOR гер,теті гер 


perform bitwise logical "exclusive or" of a register 
and memory or register 


memlreg,reg performs bitwise logical "exclusive or" of memory 


register and register 


mem|reg,numb | perform bitwise logical "exclusive or" of memory 


register and data constant 


STRING INSTRUCTIONS 


String instructions take one or two operands. The operands specify only the 
operand type, determining whether the operation is on bytes or words. If there are 
two operands, the source operand is addressed by the SI register and the destination 
operand is addressed by the DI register. The DI and SI registers are always used for 
addressing. Note that for string operations, destination operands addressed by DI 
must always reside in the Extra Segment (ES). 


Table 4-7 String Instructions 


SYNTAX RESULT 


CMPS  mem|reg,memlreg | subtract source from destination, affect flags, but 
do not return result 


LODS  memjreg transfer a byte or word from the source operand 
to the accumulator 


MOVS  memlreg,mem|reg | move 1 byte (or word) from source to destination 


SCAS теті гер subtract destination operand from accumulator 
(AX or AL), affect flags, but do not return result 


STOS теті гер transfer а byte or word from accumulator to the 
destination operand 
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Table 4-8 defines prefixes for string instructions. A prefix repeats the string instruc- 
tion the number of times contained in the CX register, which is decremented by 1 for 
each iteration. Prefix mnemonics precede the string instruction mnemonic in the 
statement line as shown in Chapter 2. 


Table 4-8 Prefix Instructions 
SYNTAX | RESULT 
repeat until CX register is zero 


repeat until CX register is zero and zero flag (ZF) is not 
Zero 


equal to "REPZ" 


repeat until CX register is zero and zero flag (ZF) is zero 


equal to "'REPNZ" 


CONTROL TRANSFER INSTRUCTIONS 


All ofthe following classes of control transfer instructions cause program execution 
to continue at some new location in memory, possibly in a new code segment. The 
transfer may be absolute or depend on a certain condition. 


€ calls, jumps, and returns 
conditional jumps 
iterational control 
interrupts 


Table 4-9 defines control transfer instructions. In the definitions of conditional 
jumps, above and below refer to the relationship between unsigned values, and 
greater than and less than refer to the relationship between signed values. 


Table 4-9 Control Transfer Instructions 


SYNTAX RESULT | 


САТА, label push the offset address of the next instruction on 
the stack, jump to the target label 
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Table 4-9 Control Transfer Instructions (cont'd) 


SYNTAX RESULT 


CALL тетјгер 16 push the offset address of the next instruction on 
the stack, jump to location indicated by contents 
of specified memory or register 


CALLF label push CS segment register on the stack, push the 
offset address of the next instruction on the stack 
(after CS), jump to the target label 


CALLF mem push CS register on the stack, push the offset 
address of the next instruction оп the stack, jump 
to location indicated by contents of specified 
double word in memory 


push the flag registers (as in PUSHF), clear TF 
and IF flags, transfer control with an indirect call 
through any one of the 256 interrupt-vector ele- 
ments - uses three levels of stack 


if OF (the overflow flag) is set, push the flag 
registers (as in PUSHF), clear TF and IF flags, 
transfer control with an indirect call through 
interrupt-vector element 4 (location 10H) - if the 
OF flag is cleared, no operation takes place 


transfer control to the return address saved by a 
previous interrupt operation, restore saved flag 
registers, as well as CS and IP - pops three levels 
of stack 


jump if "not below ог equal" or "above" ( (CF or 
ZF)20) 


jump if "not below" or "above or equal” (CF = 0) 


jumpif "below" or "пої above or equal” (CF = 1) 
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Table 4-9 Control Transfer Instructions (cont'd) 


SYNTAX RESULT 


lab8 jump if "below or equal" or "not above" ((CF or 
ZF)21) 


lab8 same as "JB" 
lab8 jump to target label if CX register is zero 
lab8 jump if "equal" or "zero" ( ZF = 1) 


lab8 jump if "not less or equal" or "greater" (((SF xor 
OF) or ZF) = 0) 


lab8 jump if "not less" or "greater ог equal” ((SF xor 
ОҒ)-0) 


lab8 jump if "less" or "not greater or equal" ((SF xor 
OF)=1) 


lab8 jump if "less or equal” or "not greater" (((SF xor 
OF) ог?Е)-!) 


label jump to the target label 


memlregl16 jump to location indicated by contents of speci- 
fied memory or register 


label jump to the target label possibly in another code 
segment 


lab8 jump to the target label within +128 bytes from 
instruction 


1а 8 same as "ЈВЕ“ 


labS8 same as "JB" 
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Table 4-9 Control Transfer Instructions (cont'd) 


SYNTAX RESULT 


same as "JAE" 

same as "JA" 

same as "JNB" 

jump if "not equal" or "not zero" ( ZF = 0) 
same as "JLE" 

same as "JL" 

same as "JGE" 

same as "JG" 

jump if "not overflow" ( ОЕ = 0) 


jump if "not parity" or "parity odd" 


jump if "not sign" 


same as "JNE" 

jump if "overflow" ( OF = 1) 

jump if "parity" or "parity even” ( РЕ = 1) 
same as "JP" 

same as "JNP" 

jump if "sign" (SF = 1) 


same as "JE" 
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Table 4-9 Control Transfer Instructions (cont'd) 


SYNTAX RESULT 


LOOP lab8 decrement CX register by one, jump to target 
label if CX is not zero 


LOOPE lab8 decrement XC register by one, jump to target 
label if CX is not zero and the ZF flag is set - “loop 
while zero" or “loop while equal” 


LOOPNE lab8 decrement CX register by one, jump to target 
label if CS is not zero and ZF flag is cleared 
-“loop while not zero” or “loop while not equal” 


LOOPNZ lab8 same as "LOOPNE" 
LOOPZ lab8 same as "LOOPE" 


RET return to the return address pushed by a previous 
CALL instruction, increment stack pointer by 2 . 


RET return to the address pushed by a previous 
CALL, increment stack pointer by 2+numb 


RETF return to the address pushed by a previous 
CALLFE instruction, increment stack pointer by 4 


RETF numb return to the address pushed by a previous 
CALLFE instruction, increment stack pointer by 
4+numb 


PROCESSOR CONTROL INSTRUCTIONS 


Processor control instructions manipulate the flag registers. Moreover, some of 
these instructions can synchronize the 8086 CPU with external hardware. 
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Table 4-10 Processor Control Instructions 


SYNTAX RESULT 


clear CF flag 


clear DF flag, causing string instructions to auto- 
increment the operand pointers 


clear IF flag, disabling maskable external inter- 
rupts 


complement CF flag 


numb8,mem|reg | dono operation other than compute the effective 
address and place it on the address bus (ESC is 
used Бу the 8087 numeric co-processor), "numb8" 
must be in the range 0-63 


PREFIX instruction, cause the 8086 processor to 
assert the buslock signal for the duration of the 
operation caused by the following instruction - 
the LOCK prefix instruction may precede any 
other instruction - buslock prevents co-processors 
from gaining the bus; this is useful for shared- 
resource semaphores 


cause 8086 processor to enter halt state until an 
interrupt is recognized 


set CF flag 


set DF flag, causing string instructions to auto- 
decrement the operand pointers 


set IF flag, enabling maskable external interrupts 


cause the 8086 processor to enter a wait state if 
the signal on its "TEST" pin is not asserted | 


4-17 


Chapter 5 
Codemacro Facilities 


INTRODUCTION TO CODEMACROS 


ASM-86 does not support traditional assembly language macros, but it does allow 
you to define your own instructions by using the CodeMacro Directive. Like 
traditional macros, codemacros are assembled wherever they appear in assembly 
language code, but there the similarity ends. Traditional macros contain assembly 
language instructions; a codemacro contains only codemacro directives. Macros 
are usually defined in the user's symbol table; ASM-86 codemacros are defined in 
the assembler's symbol table. A macro simplifies using the same block of instruc- 
tions over and over again throughout a program; a codemacro sends a bit stream to 
the output file and in effect adds a new instruction to the assembler. 


Because ASM-86 treats a codemacro as an instruction, you can invoke codemacros 
by using them as instructions in your program. The example below shows how 
MAC, an instruction defined by a codemacro, can be invoked. 


XCHG  BX,WO врз 
MAC PARI PAR? 
MUL  AX,WORD4 


Note that MAC accepts two operands. When MAC was defined, these two oper- 
ands were also classified as to type, size, and so on by defining MAC's formal 
parameters. The names of the formal parameters, however, are not fixed. They 
merely indicate where and how the actual operands are to be used. The actual names 
or values of operands are supplied when the codemacro 15 invoked. 
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The definition of a codemacro starts with a line specifying its name and its formal 
parameters, if any: 


CodeMacro <name> («formal parameter list>} 
The optional «formal parameter list» is defined as follows: 

«formal name>:<specifier letter>{<modifier letter>}{<range>} 
As stated above, the formal name is not fixed, but merely acts as a place holder. Ifa 
formal parameter list is present, the specifier letter is required and the modifier 
letter is optional. The following are possible specifier letters: 

А, С, D, E, M, R, S, X 
The following are possible modifier letters: 

b, d, w, sb 
The assembler ignores case except within strings, but for clarity, this section shows 
specifiers in uppercase and modifiers in lowercase. The following sections describe 


specifiers, modifiers, and the optional range in detail. 


The body of the codemacro describes the bit pattern and formal parameters. Only 
the following directives are legal within codemacros: 


SEGFIX 
NOSEGFIX 


These directives are unique to codemacros, and those which appear to duplicate 
ASM-86 directives (DB, DW, and DD) have different meanings in codemacro 
context. These directives are discussed in detail in later sections. The definition of 
each codemacro ends with the line: 


EndM 


^^ 


CodeMacro, EndM, and the codemacro directives are all reserved words. 
Codemacro definition syntax is defined in Backus-Naur-like form in Appendix H. 


The following examples are typical codemacro definitions. 


CodeMacro AAA 
DB 37H 
EndM 


CodeMacro DIV divisor:Eb 
SEGFIX divisor 
DB 6FH 
MODRM divisor 
EndM 


CodeMacro ESC opcode:Db(0,63),src: Eb 
SEGFIX src 
DBIT5 (1BH),3(opcode(3)) 
MODRM opcode,src 

EndM 


SPECIFIERS 


Every formal parameter must have a specifier letter that indicates what type of 
operand is needed to match the formal parameter. Table 5-1 defines the eight 
possible specifier letters. 
Table 5-1 Codemacro Operand Specifiers 
LETTER OPERAND TYPE 
Accumulator register, AX or AL. 


Code, a label expression only. 


Data, a number to be used as an immediate value. 


Effective address, either an M (memory address) or an R 
(register). 
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Table 5-1 Codemacro Operand Specifiers (cont'd) 


LETTER OPERAND TYPE 


M 
R 
S 

X 


MODIFIERS 


The optional modifier letter is a further requirement on the operand. The meaning 
of the modifier letter depends on the type of the operand. For variables, the 
following modifiers are used depending on the operand: "b" for byte, "w" for word, 

"d" for double-word and "sb" for signed byte. For numbers, the modifier: depends on 
the size of the number: "b" for -256 to 255 and "w" for other numbers. Table 5-2 
summarizes codemacro modifiers. 


Memory address. This can be either a variable or a brack- 
eted register expression. 


A general register only. 
Segment register only. 


A direct memory reference. 


Table 5-2 Codemacro Operand Modifiers 


VARIABLES qc 


-256 to 255 
anything else 


RANGE SPECIFIERS 


The optional range is specified within parentheses by either one expression or two 
expressions separated by a comma. The following are valid formats: 


(numberb) 

(register) 
(numberb,numberb) 
(numberb,register) 
(register,numberb) 
(register,register) 


where numberb is an 8-bit number, not an address. The following example specifies 
that the input port must be identified by the DX register: 


CodeMacro IN dst:Aw,port:Rw(DX) 
The next example specifies that the CL register is to contain the “count” of rotation: 
CodeMacro ROR dst:Ew,count:Rb(CL) 


The next example specifies that the “opcode” is to be immediate data, апа may range 
from 0 to 63 inclusive: 


CodeMacro ESC opcode:Db(0,63),adds:Eb 


CODEMACRO DIRECTIVES 


Codemacro directives define the bit pattern as well as make further requirements on 
how the operand is to be treated. Directives are reserved words, and those that 
appear to duplicate assembly language instructions have different meanings within 
a codemacro definition. Only the nine directives defined here are legal within 
codemacro definitions. 


SEGFIX 


If SEGFIX is present, it instructs the assembler to determine whether а segment- 
override prefix byte is needed to access a given memory location. If so, the segment- 
override prefix is output as the first byte of the instruction. If not, no action 15 taken. 
SEGFIX takes the form: 


SEGFIX <formal name> 
where <formal name> is the name of a formal parameter which represents the 


memory address. Because it represents a memory address, the formal parameter 
must have one of the specifiers E, M or X. 
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NOSEGFIX 


Use NOSEGFIX for operands in instructions that must use the ES register for that 
operand. This applies only to the destination operand of these instructions: CMPS, 
MOVS, SCAS, STOS. The following is the form of NOSEGFIX: 


NOSEGFIX segreg, <formname> 


where зергер is one of the segment registers ES, CS, SS, ог DS and «formname» is 
the name of the memory-address formal parameter, which must have a specifier E, 
M, or X. Мо code is generated from this directive, but an error check is performed. 
The following is an example of the use of NOSEGFIX: 


CodeMacro MOVS si _ptr:Ew,di_ptr:Ew 
NOSEGFIX .ES,dL ptr 
SEGFIX SL. ptr 
DB ОА5Н 


MODRM 


This directive instructs the assembler to generate the ModRM byte, which follows 
the opcode byte in many of the 8086's instructions. The ModRM byte contains 
either the indexing type or the register number to be used in the instruction. It also 
specifies which register is to be used, or gives more information to specify an 
instruction. 


The ModRM byte carries the information in three fields. The mod field occupies the 
two most significant bits of the byte, and combines with the register memory field to 
form 32 possible values: 8 registers and 24 indexing modes. 


The reg field occupies the three next bits following the mod field. It specifies either a 
register number or three more bits of opcode information. The meaning of the reg 
field is determined by the opcode byte. 


The register memory field occupies the last three bits of the byte. It specifies a 
register as the location of an operand, or forms a part of the address-mode in 
combination with the mod field described above. 


For further information of the 8086's instructions and their bit patterns, see Intel's 
8086 Assembly Language Programing Manual and the Intel 8086 Family User's 
Manual. 
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The following forms of MODRM are used: 


MODRM <form name>,<form name> 
MODRM NUMBER7,«form name> 


where NUMBER7 is a value 0 to 7 inclusive and «form name> is the name of a 
formal parameter. 


The following examples show the use of MODRM: 


CodeMacro RCR dst:Ew,count:Rb(CL) 


SEGFIX dst 
DB 0D3H 
MODRM 3,46 
EndM 
CodeMacro OR dst:Rw,src: Ew 
SEGFIX src 
DB OBH 
MODRM dst,src 


EndM 


RELB and RELW 


These directives, used in IP-relative branch instructions, instruct the assembler to 
generate displacement between the end of the instruction and the label that is 
supplied as an operand. RELB generates one byte and RELW two bytes of dis- 
placement. The directives take the following forms: 


RELB <form name> 
RELW <form name> 


where <form name> is the name of a formal parameter with a ”C” (code) specifier. 
For example: 


CodeMacro LOOP place:Cb 
DB ОЕ2Н 
RELB place 
EndM 
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DB, DW and DD 
These directives differ from those which occur outside of codemacros. Use the 
following forms of these directives: 


DB «form name» | NUMBERB 
DW «form name» | NUMBERW 
DD <form name> 


where NUMBERB is asingle-byte number, NUMBER W is atwo-byte number, and 
form name 15 a name of a formal parameter. For example: 


CodeMacro XOR dst:Ew,src:Db 


SEGFIX dst 
DB 81H 
MODRM 6,461 
DW STC 


DBIT 


This directive manipulates bits in combinations of a byte or less. The directive takes 
the following form: 


DBIT <field description>{,<field description>} 


where a field description, has two forms: 


<number><combination> 
<number>(<form name>(<rshift>)) 


where «number»? ranges from 1 to 16, and specifies the number of bits to be set. The 
<combination> parameter specifies the desired bit combination. The total of all the 
«number»s listed in the field descriptions must not exceed 16. The second form 
shown above contains «form name>, a formal parameter name that instructs the 
assembler to put a certain number in the specified position. This number normally 
refers to the register specified in the first line ofthe codemacro. The numbers used in 
this special case for each register are as follows: 


AL: 0 
CL: 1 
DL: 2 
BL: 3 
AH: 4 
CH: 5 
DH: 6 
BH: 7 
AX: O0 
CX: 1 
DX: 2 
BX: 3 
: 4 

5 

6 

7 

0 

| 

2 

3 


The parameter, <rshift>, which is contained in the innermost parentheses, specifies 
a number of right shifts. For example, "0" specifies no shift, "1" shifts right one bit, 
"2" shifts right two bits, and so on. The definition below uses this form. 


CodeMacro DEC dst:Rw 
DBIT 5(9H),3(dst(0)) 
EndM 


The first five bits of the byte have the value 9H. If the remaining bits are zero, the 
hex value of the byte will be 48H. If the following instruction is assembled: 


DEC DX 


and DX has a value of 2H, then 48H + 2H = 4AH, which is the final value of the byte 
for execution. If this sequence had been present in the definition: 


DBIT 5(9H),3(dst(1)) 


then the register number would have been shifted right once and the result would 
had been 48H + 1H = 49H, which is erroneous. 
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Chapter 6 


DDT-86 


DDT-86 OPERATION 


The DDT-86 program allows the user to test and debug programs interactively ina 
CP/M-86 environment. To use DDT-86, you should be familiar with the 8086 
processor, ASM-86 and the CP/M-86 operating system as described in the 


CP/M- 86 System Reference Guide. 


Invoking DDT86 
Invoke DDT-86 by entering one of the following commands: 


DDT86 
DDT86 filespec 


The first command loads and executes DDT-86. After displaying its sign-on mes- 
sage and prompt character (-), DDT-86is ready to accept operator commands. Тһе 
second command is similar to the first, except that after DDT-86 is loaded, the file 
specified by filespec is also loaded. If the filetype is omitted from the filespec,.CMD 
is assumed. Note that DDT-86 cannot load a file with a filetype of .H86. 


The second form of the invoking command 15 equivalent to the sequence: 


A>DDT86 
DDT86 х.х 
-Efilename 


At this point, the loaded program is ready for execution. 


DDT-86 Command Conventions 


When DDT-86 is ready to accept a command, it prompts the operator with a 
hyphen (-). In response, you can type a command line or a CONTROL-C (tC) to 
end the debugging session. А command line can have up to 64 characters, and must 
be terminated with a carriage return. When entering the command, use standard 
CP/M-86 line-editing functions (tX, tH, tR, and so forth) to correct typing errors. 
DDT-86 does not process the command line until a carriage return is entered. 
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The first character of each command line determines the command action. Table 
6-1 summarizes the DDT-86 commands, which are defined individually later in the 
chapter. 


Table 6-1 DDT-86 Command Summary 
enter assembly language statements 
display memory in hexadecimal and ASCII 
load program for execution 


fill memory block with a constant 


begin execution with optional breakpoints 


hexadecimal arithmetic 

set up file control block and command tail 
list memory using 8086 mnemonics 

move memory block 

read disk file into memory 

set memory to new values 

trace program execution 

untraced program monitoring 

show memory layout of disk file read 
write contents of memory block to disk 


examine and modify CPU state 


The command character can be followed Бу one or more arguments, consisting of 
hexadecimal values, file names or other information, depending on the command. 
Arguments are separated from each other by commas or spaces. No spaces are 
allowed between the command character and the first argument: 


Specifying a 20-Bit Address 


Most DDT-86 commands require one or more addresses as operands. Because the 
8086 can address up to 1 megabyte of memory, addresses must be 20-bit values. 
Enter a 20-bit address as follows: 


5555:ОООО 


where 5555 represents an optional 16-bit segment number and oooo is a 16-bit offset. 
DDT-86 combines these values to produce a 20-bit effective address as follows: 


55550 
T 0000 


еееее 


The optional value 5555 may беа 16-bit hexadecimal value or the name of a segment 
register. If you specify a segment register name, the value of ssss represents the 
contents of that register in the user's CPU state, as indicated by the X command. If 
omitted, a default value appropriate to the command being executed is used, as 
described later in the chapter. 


Terminating DDT-86 


Terminate DDT-86 by typing a tC in response to the hyphen prompt. This returns 
control to the CCP. Note that CP/M-86 does not have the SAVE facility found in 
CP/M for 8-bit machines. Therefore, when using DDT-86 to patch a file, write the 
file to disk with the W command before exiting DDT-86. 


DDT-86 OPERATION WITH INTERRUPTS 


DDT-86 operates with interrupts enabled or disabled, and preserves the interrupt 
state of the program being cxccuted under DDT-86. When DDT-86 has control of 
the CPU, either when it is initially invoked, or when it regains control from the 
program being tested, the condition of the interrupt flag is the same as it was when 
DDT-86 was invoked, except for a few critical regions where interrupts are dis- 
abled. While the program being tested has control ofthe CPU, the user's CPU state, 
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which can be displayed with the X command, determines the state of the interrupt 
Пар. 


DDT-86 COMMANDS 


This section defines DDT-86 commands and their arguments. DDT-86 commands 
give you control of program execution and allow you to display and modify system 
memory and the CPU state. 


The A (Assemble) Command 


The A command assembles 8086 mnemonics directly into memory. The following is 
the form of the A command: 


AS 


where s is the 20-bit address where assembly is to start. DDT-86 responds to the A 
command by displaying the address of the memory location where assembly is to 
begin. At this point enter assembly language statements as described in the Assem- 
bly Language Syntax section later in this chapter. When you enter a statement, 
DDT-86 converts it to binary, places the value(s) in memory, and displays the 
address of the next available memory location. This process continues until you 
enter a blank line or a line containing only a period. 


DDT-86 responds to invalid statements by displaying a question mark (?) and 
redisplaying the current assembly address. 


The D (Display) Command 


The D command displays the contents of memory as 8-bit or 16-bit hexadecimal 
values and in ASCII. The following are the forms of the D command: 


where s is the 20-bit address where the display is to start, and f is the 16-bit offset 
within the segment specified in s where the display is to finish. 


Memory 15 displayed on one or more display lines. Each display line shows the 
values of up to 16 memory locations. For the first three forms, the display line 
appears as follows: 


ssss:o000 bbbb...bbcc...c 


where ssss 1s the segment being displayed and oooo is the offset within segment ssss. 
Thebb's represent the contents ofthe memory locations in hexadecimal, and the c's 
represent the contents of memory in ASCII. Any nongraphic ASCII characters are 
represented by periods. 


In response to the first form shown above, DDT-86 displays memory from the 
current display address for 12 display lines. The response to the second form is 
similar to the first, except that the display address is first set to the 20-bit address s. 
Thethird form displays the memory block between locations s and f. The next three 
forms are analogous to the first three, except that the contents of memory are 
displayed as 16-bit values, rather than 8-bit values, as shown below: 


SSSS:0000 WWWW WWWW ...WWWNW CCCC...CC 


During a long display, you can abort the D command by typing any character at the 
console. 


The E (Load for Execution) Command 


The Ecommand loads a file into memory so that a subsequent G, T or Ucommand 
can begin program execution. The E command takes the form: 


Efilename 


where filename is the name of the file to be loaded. If no filetype is specified, .CMD 
is assumed. The contents of the user segment registers and IP register are altered 
according to the information in the header of the file loaded. 


An E command releases all blocks of memory allocated by any previous E or R 
commands or by programs executed under DDT-86. Therefore, only one file at a 
time may be loaded for execution. 


When the load is complete, DDT-86 displays the starting and ending addresses of 
each segment in the file loaded. Use the V command to redisplay this information at 
a later time. 
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If the file does not exist or cannot be successfully loaded in the available memory, 
DDT-86 issues an error message. 


The F (Fill) Command 


The F command fills an area of memory with a byte or word constant. The 
following are the forms of the F command: 


Fs,f,b 
FWs,f,w 


where s is a 20-bit starting address of the block to be filled, and f is a 16-bit offset of 
the final byte of the block within the segment specified in s. 


In response to the first form, DDT-86 stores the 8-bit value b in locations s through 
f. In the second form, the 16-bit value w is stored in locations s through fin standard 
form, low 8 bits first followed by high 8 bits. 


If s is greater than f or the value b is greater than 255, DDT-86 responds with a 
question mark. DDT-86 issues an error message if the value stored in memory 
cannot be read back successfully, indicating faulty or nonexistent RAM at the 
location indicated. 


The G (Go) Command 


The G command transfers control to the program being tested, and optionally sets 
one or two breakpoints. The following are the forms of the G command: 


Gs,bl 
Gs,bl,b2 


where s is a 20-bit address where program execution is to start, and БІ and b2 аге 
20-bit breakpoint addresses. If no segment value is supplied for any of these three 
addresses, the segment value defaults to the contents of the CS register. 


In the first three forms, no starting address is specified; instead, DDT-86 derives the 
20-bit address from the CS and IP registers. The first form transfers control to the 
program being tested without setting any breakpoints. The next two forms respec- 


tively set one and two breakpoints before passing control to the user's program. The 
next three forms are analogous to the first three, except that the CS and IP registers 
are first set to s. 


Once control has been transferred to the program under test, it executes in realtime 
until a breakpoint is encountered. At this point, DDT-86 regains control, clears all 
breakpoints, and indicates the address at which execution ofthe program under test 
was interrupted as follows: 


*SSSS:0000 


where ssss corresponds to the CS and оооо corresponds to the IP where the break 
occurred. When a breakpoint returns control to DDT-86, the instruction at the 
breakpoint address has not yet been executed. 


The H (Hexadecimal Math) Command 


The H command computes the sum and difference of two 16-bit values. The 
following is the form of the H command: 


Ha,b 


where a and bare the values whose sum and difference are to be computed. DDT-86 
displays the sum (ssss) and the difference (dddd) truncated to 16 bits on the next line 
as shown below: 


ssss dddd 


The I (Input Command Tail) Command 


The Icommand prepares a file control block and command tail buffer in DDT-86's 
base page, and copies this information into the base page of the last file loaded with 
the E command. The following is the form of the I command: 


Icommandtail 


where the commandtail parameter is a character string that usually contains one or 
more filenames. The first filename is parsed into the default file control block at 
005CH. The optional second filename (if specified) is parsed into the second part of 
the default file control block beginning at 006CH. The characters in the command- 
tail parameter are also copied into the default command buffer at 0080H. The 
length of command tail is stored at 0080H, followed by the character string 
terminated with a binary zero. 
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If a file has been loaded with the Ecommand, DDT-86 copies the file control block 
and command buffer from the base page of DDT-86to the base page ofthe program 
loaded. Thelocation of DDT- 86's base page can be obtained from the SS register in 
the user's CPU state when DDT-86 is invoked. The location of the base page of a 
program loaded with the E command is the value displayed for DS upon comple- 
tion of the program load. 


The L (List) Command 


The L command lists the contents of memory in assembly language. The following 
forms of the L command are used: 


L 
Ls 
Ls,f 


where s is the 20-bit address at which the list is to start, and f is a 16-bit offset within 
the segment specified in s where the list is to finish. 


The first form lists twelve lines of disassembled machine code from the current list 
address. The second form sets the list address to s, then lists twelve lines of code. The 
last form lists disassembled code from s through f. In all three cases, the list address 
is set to the next unlisted location in preparation for a subsequent L command. 
When DDT-86 regains control from a program being tested (see G, T and U 
commands), the list address is set to the current value of the CS and IP registers. 


Long displays сап be aborted by typing any key during the list process. Enter tS to 
halt the display temporarily. 


The syntax of the assembly language statements produced by the L command is 
described later in the chapter. 


The M (Move) Command 


The M command moves a block of data values from one area of memory to another. 
The following is the form of the M command: 


Ms,f,d 


where s is the 20-bit starting address of the block to be moved, f is the offset of the 
final byte to be moved within the segment described by s, and d is the 20-bit address 


of the first byte of the area to receive the data. If the segment is not specified in d, the 
value equals that used for s. Note that if the value of d is between s and f, part ofthe 
block being moved will be overwritten before it is moved, because data is trans- 
ferred starting from location s. 


The R (Read) Command 


The R command reads a file into a contiguous block of memory. The following is 
the form of the R command: 


Rfilename 
where filename is the name and type of the file to be read. 


DDT-86 reads the file into memory and displays the starting and ending addresses 
of the block of memory occupied by the file. Note that a V command can redisplay 
this information at a later time. The default display pointer (for subsequent D 
commands) is set to the start of the block occupied by the file. 


The R command does not free any memory previously allocated by another R or E 
command. Therefore, a number of files can be read into memory without overlap- 
ping. The number of files that can be loaded is limited to seven, which is the number 
of memory allocations allowed by the BDOS, minus one for DDT-86 itself. 


If the file does not exist or there is not enough memory to load the file, DDT-86 
issues an error message. 


The S (Set) Command 


The S command can change the contents of bytes or words of memory. The 
following forms of the S command are used: 


Ss 
SWs 


where s is the 20-bit address at which the change is to occur. 


DDT-86 displays the memory address and its current contents on the following line. 
In response to the first form, the display appears as follows: 


SSSS:0000 bb 
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In response to the second form, the display appears as follows: 
5555:0000 WWWW 


In the above examples, bb and wwww аге the contents of memory in byte and word 
formats, respectively. 


In response to one of the above displays, you can choose to alter the memory 
location or to leave it unchanged. If you enter a valid hexadecimal value, the 
contents of the byte (or word) in memory is replaced with the value. If no value is 
entered, the contents of memory are unaffected and the contents ofthe next address 
are displayed. In either case, DDT-86 continues to display successive memory 
addresses and values until either a period or an invalid value is entered. 


DDT-86 issues an error message if the value stored in memory cannot be read back 
successfully, indicating faulty or nonexistent RAM at the location indicated. 


The T (Trace) Command 


The T command traces program execution for 1 to OFFFFH program steps. The 
following forms of the T command are used: 


where n is the number of instructions to execute before returning control to the 
console. 


Before an instruction is executed, DDT-86 displays the current CPU state and the 
disassembled instruction. In the first two forms, the segment registers are not 
displayed, allowing the entire CPU state to be displayed on one line. The next two 
forms are analogous to the first two, except that all the registers are displayed, 
forcing the disassembled instruction to be displayed on the next line as in the X 
command. 


In all of the forms, control transfers to the program under test at the address 
indicated by the CS and IP registers. If n is not specified, one instruction is executed. 
Otherwise DDT-86 executes n instructions, displaying the CPU state before each 
step. А long trace may be aborted before n steps have been executed by typing any 
character at the console. 


After a Т command, the list address used іп the L command is set to the address of 
the next instruction to be executed. 


Note that DDT-86 does not trace through a BDOS interrupt instruction, since 
DDT-86 itself makes BDOS calls and the BDOS is not reentrant. Instead, the entire 
sequence of instructions from the BDOS interrupt through the return from BDOS is 
treated as one traced instruction. 


The U (Untrace) Command 


Тһе U command is identical to the T command except that the CPU state 15 
displayed only before the first instruction is executed, rather than before every step. 
The following forms of the U command are used: 


where n is the number of instructions to execute before returning control to the 
console. The U command may be aborted before n steps have been executed by 
typing any key at the console. 


The V (Value) Command 


The V command displays information about the last file loaded with the E or R 
commands. The following is the form of the V command: 


V 


If thelast file was loaded with the Ecommand, the V command displays the starting 
and ending addresses of each of the segments contained in the file. If the last file was 
read with the R command, the V command displays the starting and ending 
addresses of the block of memory where the file was read. If neither the R nor E 
commands have been used, DDT-86 responds to the V command with a question 
mark (?). 


The W (Write) Command 


The W command writes the contents of a contiguous block of memory to disk. The 
following forms of the W command are used: 


Wfilename 
Wfilename,s,f 
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where filename is the filename and filetype of the disk file to receive the data, and s 
and f are the 20-bit first and last addresses of the block to be written. If the segment 
is not specified in f, DDT-86 uses the same value used for s. 


If the first form is used, DDT-86 assumes the s and f values from the last file read 
with an R command. If no file was read with an R command, DDT-86 responds 
with a question mark (?). This form is useful for writing out files after patches have 
been installed, assuming the overall length of the file is unchanged. 


In the second form where s and f are specified as 20-bit addresses, the low four bits 
of s are assumed to be 0. Thus the block being written must always start on a 
paragraph boundary. 


Ifthe file with the name specified in the W command already exists, DDT-86 deletes 
it before writing a new file. 


The X (Examine CPU State) Command 


The X command allows the operator to examine and alter the CPU state of the 
program under test. The following forms of the X command are used: 


X 
Xr 
Xf 


where r is the name of one of the 8086 CPU registers and f is the abbreviation of one 
of the CPU flags. The first form displays the CPU state in the format: 


AX BX CX ... SS ES ІР 
— XXXX XXXX XXXX . . . XXXX XXXX XXXX 
«instruction? 


The nine hyphens at the beginning of the line indicate the state of the nine CPU 
flags. Each position can be either a hyphen, indicating that the corresponding flag is 
not set (0), or a one-character abbreviation ofthe flag name, indicating that the flag 
is set (1). Theabbreviations of the flag names are shown in Table 6-2. The value for 
instruction is the disassembled instruction at the next location to be executed, 
indicated by the CS and IP registers. 


Table 6-2 Flag Name Abbreviations 


О Overflow 

D Direction 

I Interrupt Enable 
T Trap 

S Sign 

Z Zero 

А Auxiliary Carry 
P Parity 

C Carry 


The second form allows you to alter the registers in the CPU state of the program 
being tested. The r following the X is the name of one of the 16-bit CPU registers. 
DDT-86 responds by displaying the name of the register followed by its current 
value. If a carriage return is typed, the value of the register is not changed. If a valid 
value is typed, the contents of the register are changed to that value. In either case, 
the next register is then displayed. This process continues until a period or an invalid 
value is entered, or the last register is displayed. 


The third form allows you to alter one of the flags in the CPU state of the program 
being tested. DDT-86 responds by displaying the name of the flag followed by its 
current state. If a carriage return is typed, the state of the flag is not changed. If a 
valid value is typed, the state ofthe flag is changed to that value. Only one flag may 
be examined or altered with each Xf command. Set or reset flags by entering a value 
of 1 or O. 


DEFAULT SEGMENT VALUES 


DDT-86 has an internal mechanism that keeps track of the current segment value, 
making segment specification an optional part of a DDT-86 command. DDT-86 
divides the command set into two types of commands, according to which segment 
a command defaults if no segment value is specified in the command line. 


Thc first type of command pertains to the code segment: A (Assemble), L (List 
Mnemonics) and W (Write). These commands use the internal type-1 segment value 
if no segment value is specified in the command. 


DDT-86 


6-13 


DDT-86 


6-14 


When invoked, DDT-86sets thetype-1 segment value to 0, and changes it when one 
of the following actions is taken: 


When a file is loaded by an E command, DDT-86 sets the type-1 segment 
value to the value of the CS register. 


When a file is read-by an R command, DDT-86 sets the type-1 segment 
value to the base segment where the file was read. 


When ап X command changes the value ofthe CS register, DDT-86 changes 
the type-1 segment value to the new value of the CS register. 


When DDT-86 regains control from a user program after а С, T or U 
command, it sets the type-1 segment value to the value of the CS register. 


When a segment value is specified explicitly in an A or L command, 
DDT-86 sets the type-1 segment value to the segment value specified. 


The second type of command pertains to the data segment: D (Display), F (Fill), M 
(Move) and S (Set). These commands use the internal type-2 segment value if no 
segment value is specified in the command. 


When invoked, DDT-86sets thetype-2 segment value to 0, and changes it when one 
of the following actions is taken: 


When a file is loaded by an E command, DDT-86 sets the type-2 segment 
value to the value of the DS register. 


When a file is read by an R command, DDT-86 sets thetype-2 segment value 
to the base segment where the file was read. 


When an X command changes the value of the DS register, DDT-86 
changes the type-2 segment value to the new value of the DS register. 


When DDT-86 regains control from a user program after a G, T or U 
command, it sets the type-2 segment value to the value of the DS register. 


When a segment value is specified explicitly in a D, F, M or S command, 
DDT-86 sets the type-2 segment value to the segment value specified. 


When evaluating programs that use identical values in the CS and DS registers, all 
DDT-86 commands default to the same segment value unless explicitly overridden. 


Note that the G (Go) command does not fall into either group, since it defaults to 
the CS register. 
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Table 6-3 summarizes DDT-86's default segment values. 


Table 6-3 DDT-86 Default Segment Values 


| COMMAND 


ОФ 


Е 
Е 
С 
Н 
І 
L 
M 
R 
S 
T 
U 
V 
W 
X 


x - use this segment default if none specified; 
change default if specified explicitly 
c -change this segment default 


ASSEMBLY LANGUAGE SYNTAX FOR A AND L COMMANDS 


In general, the syntax of the assembly language statements used in the A and L 
commands is standard 8086 assembly language. Several minor exceptions are listed 
below. 


e DDT-86 assumes that all numeric values entered are hexadecimal. 
€ Кр ко three prefixes (LOCK, repeat, segment override) may appear in one 


statement, but they all must precede the opcode of the statement. Alter- 
nately, a prefix may be entered on a line by itself. 
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Ф The distinction between byte and word string instructions is made as 


follows: 
byte word 
LODSB LODSW 
STOSB STOSW 
SCASB SCASW 
MOVSB MOVSW 
CMPSB CMPSW 


е The mnemonics for near and far control transfer instructions аге as follows: 


short normal far 

JMPS JMP JMPF 
CALL CALLF 
RET RETF 


ө If the operand of a CALLF or JMPF instruction is a 20-bit absolute 
address, it is entered in the following form: 


SSSS:0000 
where 5555 is the segment and оооо is the offset of the address. 


€ Operands that could refer to either a byte or word are ambiguous, and must 
be preceded either by the prefix BYTE or WORD. These prefixes may be 
abbreviated to BY and WO. For example: 


INC BYTE [BP] 
NOT WORD [1234] 


Failure to supply a prefix when needed results in an error message. 


@ Operands which address memory directly are enclosed in square brackets to 
distinguish them from immediate values. For example: 


ADD АХ,5 ;add 5 to register АХ 
ADD AX,[5] ‚ааа the contents of location 5 to AX 
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ө The following are forms of register indirect memory operands: 


[pointer register] 
[index register] 


[pointer register + index register] 


where the pointer registers are BX and BP, and the index registers are SI and 
DI. Any of these forms can be preceded by a numeric offset. For example: 


ADD BX,[BP- SI] 
ADD BX,3[BP- SI] 
ADD BX,1D47[BP- SI] 


DDT-86 SAMPLE SESSION 


In the following sample session, a simple sort program is interactively debugged. 
Comments that explain the steps involved are in italics. 


Source file of program to test. 
A>type sort.a86 


э 


: simple sort program 
sort: 
mov 61,0 
mov  bx,offset nlist 
mov sw,0 
comp: 
mov  al,bx-si] 
cmp  al,l[bx-si] 
jna inci 
xchg а! [6х+1] 
mov [bx+si],al 
mov  sw,l 
inci: 
inc 61 
стр  si,count 
jnz comp 
test  sw,l 
jnz sort 


‘initialize index 
‚Бх = base of list 
;clear switch flag 


‚сеї byte from list 
;compare with next byte 
;don't switch if in order 
;do first part of switch 
;do second part 

set switch flag 


‘increment index 
send of list? 

sno, keep going 
;done - any switches? 
syes, sort Some more 
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done: 
jmp done ;get here when list ordered 
| dseg | 
org 100h sleave space for base page м“ 
nlist db 3,8,4,6,31,6,4,1 
count equ offset $ - offset nlist 
SW db 0 
end 
Assemble program. 
А>а51186 sort 
CP/M 8086 ASSEMBLER VER 1.1 
END OF PASS 1 
END OF PASS 2 
END OF ASSEMBLY. NUMBER OF ERRORS: 0 
Type listing file generated by ASM-86 
A>type sort.lst Ф 
CP/M ASMS6 1.1 SOURCE: SORT.A86 
А simple sort program 
sort: 
0000 ВЕ0000 mov 651,0 ‘initialize index 
0003 ВВ0001 mov  bx,offset nlist ;bx = base of list 
0006 C606080100 mov sw,0 clear switch Пар 
comp: 
000B 8A00 mov  al[bx-si] :get byte from list 
000D 3A4001 стр  al,l[bx-si] ;compare with next byte 
0010 760A Ша inci ;don’t switch if in order 
0012 864001 xchg al,l[bx-si] ;do first part of switch 
0015 8800 mov [bx+si],al ‚ао second part 
0017 C606080101 mov. sw,l set switch flag 
inci: — 
001С 46 ІПС 61 ‘Increment index 
001D 83 ЕЕОВ стр  si,count :end of list? 
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0020 75E9 jnz сотр sno, keep going 
0022 F606080101 test  sw,l ;done - any switches? 
0027 75D7 jnz богі ;yes, sort some more 
done: 
0029 E9FDFF jnp done ;get here when list ordered 
dseg 
Р org 100һ ;leave space for base page 


0100 030804061F06 nlist db 3,8,4,6,31,6,4,1 
0401 
0008 count еди offset $ - offset nlist 
0108 00 SW db 0 
end 


END OF ASSEMBLY. NUMBER OF ERRORS: 0 


Type symbol table file generated by ASM-86. 


A>type sort.sym 
0000 VARIABLES 
0100 NLIST 0108 SW 


0000 NUMBERS 
0008 COUNT 


0000 LABELS 
000B COMP 0029 DONE 001C INCI 0000 SORT 


. Type hex file generated by ASM-86. 


A>type sort.h86 

:0400000300000000F9 
:1B000081BE0000BB0001C6060801008A003A4001760A8640018800C60608016C 
:11001B81014683FE0875E9F60608010175D7E9FDFFEE 
:09010082030804061Ғ0604010035 

:00000001FF 


Generate CMD file from Н86 file. 


A>gencmd sort 


BYTES READ 0039 
RECORDS WRITTEN 04 
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Invoke DDT-86 and load SORT.CMD. 


A>ddt86 sort 
DDT86 1.0 
START END 
CS 047D:0000 047D:002F 
DS 0480 :0000 0480 :010F 


Display initial register values. 
-X 
AX BX CX DX SP BP SI DI CS DS SS ES IP 


--------- 0000 0000 0000 0000 119Е 0000 0000 0000 047D 0480 0491 0480 0000 
MOV 51, 0000 


Disassemble the beginning of the code segment. 
-| 

047D:0000 МОУ 51,0000 
047D:0003 MOV ВХ,0100 
047D:0006 MOV BYTE [0108],00 
047D:000B MOV AL, [BX+SI] 
047D:000D CMP AL,01[BX-SI] 
047D:0010 JBE 001C 
047D:0012 XCHG  AL,;OI[BX-SI] 
0470:0015 MOV  J[BX-SILAL 
047D:0017 MOV BYTE [0108],01 
047D:001C INC SI 

047D:001D CMP SI,0008 
0470:0020 JNZ 000B 


Display the start of the data segment. 


-d100,10f | 
0480:0100 03 08 04 06 ІҒ 06 04 01 00 00 00 00 00 00 00 00 ............ 


Disassemble the rest of the code. 


-| 
047D:0022 TEST BYTE [01081,01 
047D:0027 JNZ 0000 | 
047D:0029 JMP 0029 
047D:000C ADD  [BX+SI],AL 
047D:002E ADD  [BX-SILAL 
047D:0030 DAS 


047D:0031 ADD  [BX+SI],AL 
047D:0033 %- 6C 
047D:0034 POP ES 
047D:0035 ADD  [BX],CL 
047D:0037 ADD  [BX-SILAX 
047D:0039 %- 6F 


Execute program from IP (-0) setting breakpoint at 29H. 
-g.29 
*047D:0029 


Breakpoint encountered. Display sorted list. 
-d100, 10f 


0480:0100 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 


Doesn't look good. Reload file. 


-esort 

START END 
CS 047D:0000 047D:002F 
DS 0480 :0000 0480 :010F 


Trace 3 instructions. 


-t3 

AX BX CX DX SP BP SI DI IP 
-----Z-P- 0000 0100 0000 0000 119E 0000 0008 0000 0000 
-----Z-P- 0000 0100 0000 0000 119E 0000 0000 0000 0003 
-----Z-P- 0000 0100 0000 0000 119E 0000 0000 0000 0006 
*047D:000B 


Trace some more. 


-t3 

AX BX CX DX SP BP SI DI IP 
------- Z-P 0000 0100 0000 0000 119Е 0000 0000 0000 000B 
------- Z-P 0003 0100 0000 0000 119Е 0000 0000 0000 000D 
----S-A-C 0003 0100 0000 0000 119Е 0000 0000 0000 0010 
*047D:001C 


Display unsorted list. 
-d100,10f 


0480:0100 03 08 04 06 1F 06 04 01 00 00 00 00 00 00 00 00 


MOV 
MOV 
MOV 


MOV 
CMP 
JBE 


DDT-86 


51,0000 
ВХ,0100 
ВҮТЕ (01081,00 


AL, [BX + SI] 
AL, 01 [BX + SI] 
001C 
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Display next instructions to be executed. 


-| 
047D:001C 
047D:001D 
047D:0020 
047D:0022 
047D:0027 
047D:0029 
047D:002C 
047D:002E 
047D:0030 
047D:003 1 
047D:0033 
047D:0034 


INC 
CMP 
JNZ 
TEST 
JNZ 
JMP 
ADD 
ADD 
DAS 
ADD 
"= 
РОР 


Trace some more. 


-t3 


--5-А-С 


--5-АРС 
*047D:000B 


SI 

51.0008 

000В 

BYTE [0108],01 
0000 

0029 
[BX-SI,AL 
[BX+SI],AL 


[BX+SI],AL 
6C 
ES 


AX BX CX DX SP BP SI DI ІР 
0003 0100 0000 0000 119E 0000 0000 0000 001C 
0003 0100 0000 0000 119E 0000 0001 0000 001D CMP 
0003 0100 0000 0000 119E 0000 0001 0000 0020 


INC 


JNZ 


Display instructions from current IP. 


-| 
047D:000B 
047D:000D 
047D:0010 
047D:0012 
047D:0015 
047D:0017 
047D:001C 
047D:001D 
D47D:0020 
047D:0022 
047D:0027 
047D:0029 


AL,[BX-SI] 
AL,OI[BX-SI] 
001C 
AL,OI[BX- SI] 
[BX+SI],AL 
BYTE [0108],01 
SI 


SI 
51,0008 
000В 


“4 


-[3 
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AX BX CX DX SP BP SI DI IP 


----S-APC 0003 0100 0000 0000 119E 0000 0001 0000 0008 MOV  AL;[BX-SI] 
----S-APC 0008 0100 0000 0000 119E 0000 0001 0000 000D СМР AL,OI[BX+ST] 
--------- 0008 0100 0000 0000 119E 0000 0001 0000 0010 JBE 001C 


*047D:0012 


-l 
047D:0012 
047D:0015 
047D:0017 
047D:001C 
047D:001D 
047D:0020 
047D:0022 
047D:0027 
047D:0029 
047D:002C 
047D:002E 
047D:0030 


XCHG 
MOV 
MOV 
INC 
CMP 
JNZ 
TEST 
JNZ 
JMP 
ADD 
ADD 
DAS 


AL,OI[BX-SI] 
[BX-SI], AL 
BYTE [0108],01 


BYTE [0108],01 
0000 

0029 
[BX+SI],AL 
[BX+SI], AL 


Go until switch has been performed. 


-р,20 


*047D:0020 


Display list. 
-d100.10f 


0480:0100 03 04 08 06 IF 06 04 01 01 00 00 00 00 00 00 00 ............ 


Looks like 4 and 8 were switched okay. (And toggle is true.) 


-t 


AX BX CX DX SP BP SI DI ІР 


----S-APC 0004 0100 0000 0000 119E 0000 0002 0000 0020 JNZ 000B 


*047D:000B 
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Display next instructions. 

-] 

047D:000B MOV AL, [BX+SI] 
047D:000D CMP AL,01[BX-SI] 
047D:0010 JBE 001C 
047D:0012  XCHG  AL,;OI[BX-SI] 
047D:0015 MOV [BX+SI],AL 
047D:0017 MOV BYTE [0108],01 
047D:001C INC SI 

047D:001D CMP 51,0008 
0470:0020 JNZ 000B 
047D:0022 TEST  . BYTE [0108],01 
047D:0027 ЛЧ2 0000 
0470:0029 JMP 0029 


Since switch worked, reload and check boundary conditions. 


-esort 

START END 
CS 047D:0000 047D:002F 
DS 0480:0000 0480 :010F 


Make it quicker by setting list length to 3. (Could also have used s47d-1e.) 


-ald 
047D:001D cmp $1,3 
047D:0020 


Display unsorted list. 


-d100 

0480:0100 03 08 04 06 ІҒ 06 04 01 00 00 00 00 00 00 00 00 ............ 
0480:0110 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 00 ............ 
0480:0120 00 00 00 00 00 00 00 00 00 00 00 00 00 20 20 20 ............ 


Set breakpoint when first 3 elements of list should be sorted. 


-g,29 
*047D:0029 


See if list is sorted. 


-d100,10f 
0480:0100 03 04 06 08 IF 06 04 01 00 00 00 00 00 00 00 00 ............ 
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Interesting. The fourth element seems to have been sorted in. 


-esort 

START END 
CS 047D:0000 047D:002F 
DS 0480 :0000 0480 :010F 


Let's try again with some tracing. 


-ald 
047D:001D cmp si,3 
047D:0020 . 


-t9 

AX BX CX DX SP BP SI DI ІР 
-----Z-P- 0006 0100 0000 0000 119E 0000 0003 0000 0000 MOV 51,0000 
-----Z-P- 0006 0100 0000 0000 119Е 0000 0000 0000 0003 MOV BX,0100 
-----Z-P- 0006 0100 0000 0000 119Е 0000 0000 0000 0006 MOV BYTE [0108],00 
-----Z-P- 0006 0100 0000 0000 119E 0000 0000 0000 000B MOV  AL;[BX-SI] 
-----Z-P- 0003 0100 0000 0000 119E 0000 0000 0000 0000 CMP  AL,OI[BX+SI] 
----S-A-C 0003 0100 0000 0000 119E 0000 0000 0000 0010 JBE 001C 
----S-A-C 0003 0100 0000 0000 119E 0000 0000 0000001C INC SI 
---------- С 0003 0100 0000 0000 119E 0000 0001 0000 0010 CMP 51,0003 
----S-A-C 0003 0100 0000 0000 119E 0000 0001 0000 0020 JNZ (000В 
*047D:000B 


-l 


047D:0008 MOV AL,[BX+SI] 
047D:000D СМР . AL,OI[BX- SI] 
047D:0010 JBE 001C 
047D:0012 XCHG AL,O1[BX+SI] 
047D:0015 MOV  [BX+SI],AL 
047D:0017 MOV BYTE [0108],01 
047D:001C INC SI 

047D:001D CMP 51,0003 
047D:0020 JNZ 000B 
047D:0022 TEST BYTE [0108],01 
047D:0027 JNZ 0000 
0470:0029 JMP 0029 
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-t3 


AX BX CX DX SP BP SI DI ІР 
----S-A-C 0003 0100 0000 0000 119E0000 0001 0000000B MOV  AL,[BX-SI] 
----S-A-C 0008 0100 0000 0000 119Е 0000 0001 0000 0000 СМР AL,OI[BX+SI]] 
--------- 0008 0100 0000 0000 119E 0000 0001 0000 0010 JBE 001C 
*047D:0012 


4 


0470:0012 XCHG AL,OI[BX+S]] 
047D:0015 MOV [BX+SI],AL 
047D:0017 MOV BYTE [0108],01 
047D:001C INC SI 

047D:001D CMP 51,0003 
047D:0020 JNZ 000B 
047D:0022 TEST BYTE [0108],01 


AX BX CX DX SP BP SI DI IP 
--------- 0008 0100 0000 0000 119E 0000 0001 00000012 XCHG . AL,OI[BX- SI] 
--------- 0004 0100 0000 0000 119Е 0000 0001 00000015 MOV [BX+SI],AL 
--------- 0004 0100 0000 0000 119E 0000 0001 0000 0017 MOV BYTE [ 0108],01 
*047D:001C 


-d100,10 f | 
0480:0100 03 04 08 06 IF 06 04 01 01 00 00 00 00 00 00 00 ................ 


So far, so good. 


AX BX CX DX SP BP SI DI ІР 
--------- 0004 0100 0000 0000 119E 0000 0001 0000 001C INC SI 
--------- 0004 0100 0000 0000 119E 0000 0002 00000010 CMP 51,0003 
--S-APC 0004 0100 0000 0000 119Е 0000 0002 0000 0020 JNZ 000В 
*047D:000B 


-| 


047D:000B MOV AL,[BX-SI] 
047D:000D CMP AL,OI[BX+S]] 
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047D:0010 JBE 001C 
047D:0012 XCHG AL,OI[BX+SIT] 
047D:0015 MOV [BX+SI],AL 
047D:0017 MOV BYTE [0108],01 
047D:001C INC SI 

047D:001D CMP 51,0003 
047D:0020 JNZ 000B 
047D:0022 TEST BYTE [0108],01 
047D:0027 JNZ 0000 
047D:0029 JMP 0029 


-t3 


AX BX CX DX SP BP SI DI IP 
----S-APC 0004 0100 0000 0000 119Е 0000 0002 0000000B MOV  AL;[BX-SI] 
----S-APC 0008 0100 0000 0000 119E 0000 0002 0000 0000 СМР  AL,OI(BX- SI] 
--------- 0008 0100 0000 0000 119Е 0000 000200000010 ВЕ 00ІС 
*047D:0012 


Sure enough, it's comparing the third and fourth elements of the list. Reload program. 


-esort 


START END 
CS 047D:0000 047D:002F 
DS 0480 :0000 0480 :010F 


-| 


047D:0000 MOV 51,0000 
047D:0003 MOV BX,0100 
047D:0006 MOV BYTE [0108],00 
047D:000B MOV AL,[BX-SI] 
047D:000D CMP AL,OI[BX-SI] 
047D:0010 JBE 001C 
047D:0012 XCHG  AL,;0I[BX-SI] 
047D:0015 MOV [BX+SI],AL 
047D:0017 MOV BYTE [0108],01 
047D:001C INC SI 

047D:001D CMP SI,0008 
0470:0020 JNZ 000B 
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Patch length. 


-ald 


047D:001D стр 51,7 
04710:0020 


Try it out. 


-g,29 
*047D:0029 


See if list is sorted. 


-d100,10f 
0480:0100 01 03 04 04 06 06 08 1F 00 00 00 00 00 00 00 00 ............... 


Looks better. Install patch in disk file. To do this, must read CMD file including 
header, so we can use R command. 


-rsort.cmd 


SIART END 
2000:0000 2000:01FF 


First 80h bytes contain header, so code starts at 80h. 


-180 


2000:0080 МОУ SI,0000 
2000:0083 MOV ВХ,0100 
2000:0086 MOV BYTE [0108],00 
2000:008B MOV AL[BX+SI] 
2000:008D СМР AL,0I[BX+SI] 
2000:0090 JBE 009C 
2000:0092 ХСНО  AL,;0I[BX-SI] 
2000:0095 МОУ  [BX+SI],AL 
2000:0097 MOV BYTE [0108],01 
2000:009C INC SI 

2000:009D CMP S1,0008 
2000:00A0 JNZ 008В 


Install patch. 


-a9d 


2000:009D стр si,7 
2000:00A0 


Write file back to disk. (Length of file assumed to be unchanged since no length 
specified). 


-wsort.cmd 
Reload file. 


-esort 


START END 
CS 047D:0000 047D:002F 
DS 0480 :0000 0480 :010F 


Verify that patch was installed. 


- 
047D:0000 MOV 51.0000 
047D:0003 MOV ВХ,0100 
047D:0006 MOV BYTE [0108],00 
047D:000B MOV AL,[BX+SI] 
047D:000D СМР АШ,0ЦВХ--51) 
047D:0010 JBE 001C 
047D:0012 XCHG AL,OI[BX+S]] 
0470:0015 MOV  [BX+SI],AL 
047D:0017 MOV BYTE [0108],01 
047D:001C INC SI 

047D:00D СМР SI,0007 
047D:0020 JNZ 000B 


Run it. 


-g,29 
*047D:0029 
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Still looks good. Ship it! 


-d100,10f 
0480:0100 01 03 04 04 06 06 08 1F 00 00 00 00 00 00 00 00 ................ 


-AC 


A> 
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А5М-86 Invocation 


Command: 


ASM86 
Syntax: 
ASMS6 filename { $ parameters } 
where filename is the 8086 assembly source file. Drive 
and extension are optional. The default 
file extension is .A86. 
parameters are a one-letter type followed by a 

one-letter device from the table below. 


Parameters: 


form: $ Td where T = type and d = device 


Table A-1 Parameter Types and Devices 


DEVICES PARAMETERS 


x = valid, d = default 
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ASM-86 Invocation 


Table A-1 Parameter Types and Devices (cont'd) 


DEVICES PARAMETERS 


x = valid, d = default 


Valid Parameters 


Except for the F type, the default device is the current default drive. 


Table A-2 Parameter Types 


controls location of ASSEMBLER source file 
controls location of HEX file 
controls location of PRINT file 


controls location of SYMBOL file 


controls type of hex output FORMAT 
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ASM-86 Invocation 


Table A-3 Device Types 


A-D Drives A - D 

X console device 

Y printer device 

Z byte bucket 

I Intel hex format 

D Digital Research hex format 


Table А-4 Invocation Examples 


А5М86 IO Assemble file IO. A86, produce 
IO.HEX IO.LST and IO.SYM. 


ASM86 IO.ASM $ AD SZ Assemble file IO. ASM on device D, 
produce IO.LST and IO.HEX, no 
symbol file. 


А5М86 IO 5 PY SX Assemble file IO. A86, produce 
IO.HEX , route listing directly to 
printer, output symbols on console. 


ASMS6 IO $ FD Produce Digital Research hex format. 


ASM86 IO $ FI Produce Intel hex format. 


ÁN 


Appendix B 


Mnemonic Differences from 
the Intel Assembler 


The CP/M 8086 assembler uses the same instruction mnemonics as the INTEL 8086 
assembler except for explicitly specifying far and short jumps, calls and returns. The 
following table shows the four differences. 


Table B-1 Mnemonic Differences 


MNEMONIC FUNCTION CP/M INTEL 


Intra segment short jump: 


Inter segment jump: 


Inter segment return: 


Inter segment call: 


Format 


ASM-86 produces machine code in either Intel or Digital Research hexadecimal 
format. The Intel format is identical to the format defined by Intel for the 8086. The 
Digital Research format is nearly identical to the Intel format, but adds segment 
information to hexadecimal records. Output of either format can be input to 
GENCMD, but the Digital Research format automatically provides segment iden- 
tification. А segment is the smallest unit of a program that can be relocated. 


Table C-1 defines the sequence and contents of bytes in a hexadecimal record. Each 
hexadecimal record has one of the four formats shown in Table C-2. An example of 
a hexadecimal record is shown below. 


Byte number = > 012345678090 .................. n 


Contents = »:1llaaaattddd .................... сс CR LF 


Table C-1 Hexadecimal Record Contents 


record mark 
record length 
load address 


record type 
data bytes 
check sum 
carriage return 
line feed 
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Table C-2 Hexadecimal Record Formats 


RECORD TYPE CONTENT FORMAT 


Data record :11 aaaa DT «data...» cc 


End-of-file :00 0000 01 FF 


Extended address 
mark :02 0000 ST ssss cc 


Start address :04 0000 03 5555 111 cc 


-» record length — number of data bytes 
-» check sum — sum of all record bytes 
-» 16 bit address 

-> 16 bit segment value 

-» offset value of start address 

-» data record type 

=> segment address record type 


It is in the definition of record types 00 and 02 that Digital Research's hexadecimal 
format differs from Intel's. Intel defines one value each for the data record type and 
the segment address type. Digital Research identifies each record with the segment 
that contains it, as shown in Table C-3. 


Table C-3 Segment Record Types 


INTEL’S | DIGITAL’S 
SYMBOL | VALUE VALUE MEANING 


DT for data belonging to all 8086 segments 


for data belonging to the CODE segment 


for data belonging to the DATA segment 


for data belonging to the STACK segment 


for data belonging to the EXTRA segment 
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Table C-3 Segment Record Types (cont'd) 


INTEL’S | DIGITAL'S 
VALUE VALUE MEANING 


02 for all segment address records 


SYMBOL 


SI 


for a CODE absolute segment address 
for a DATA segment address 
for a STACK segment address 


for a EXTRA segment address 
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Reserved Words 


Table D-1 Reserved Words 


Predefined Numbers 


Operators 


GT LE 


AND 


MOD 


SHL SHR 


LENGIH 


OFFSET 


Assembler Directives 


DB DD DW 


RS 


RB RW END EQU 


ORG CSEG DSEG 


SSEG 


EJECT 


ENDIF TITLE NOLIST 


INCLUDE SIMFORM PAGESIZE 


CODEMACRO | PAGEWIDIH 


Codemacro Directives 


DD DW DBIT 


RELW MODRM SEGFIX NOSEGFIX 


Reserved Words 


Table D-1 Reserved Words (cont'd) 
8086 Registers 


AX 


CH 


DI 


SI 


D-2 


Instruction Mnemonics - See Appendix E. 


Appendix E 
ASM-86 Instruction summary 


Table E-1 ASM-86 Instruction Summary 


MNEMONIC DESCRIPTION 


ASCII Adjust for Addition 
ASCII Adjust for Division 
ASCII Adjust for Multiplication 
ASCII Adjust for Subtraction 
Add with Carry 
Add 
And 

a Call (intra segment), 

| Call (inter segment) 

Convert Byte to Word 
Clear Carry 
Clear Direction 
Clear Interrupt 
Complement Carry 
Compare 
Compare Byte or Word (of string) 
Convert Word to Double Word 
Decimal Adjust for Addition 
Decimal Adjust for Subtraction 
Decrement 
Divide 
Escape 
Halt 
Integer Divide 

F^ Integer Multiply 
Input Byte or Word 
Increment 
Interrupt 


ж. 


Е-1 


ASM-86 Instruction Summary 
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Table E-1 ASM-86 Instruction Summary (cont'd) 


MNEMONIC DESCRIPTION 


Interrupt on Overflow 
Interrupt Return 

Jump on Above 

Jump on Above or Equal 
Jump on Below 

Jump on Below or Equal 
Jump on Carry 

Jump on CX Zero 

Jump on Equal 

Jump on Greater 

Jump on Greater or Equal 
Jump on Less 

Jump on Less or Equal 
Jump (intra segment) 

Jump (inter segment) 

Jump (8 bit displacement) 
Jump on Not Above 

Jump on Not Above or Equal 
Jump on Not Below 

Jump on Not Below or Equal 
Jump on Not Carry 

Jump on Not Equal 

Jump on Not Greater 
Jump on Not Greater or Equal 
Jump on Not Less 

Jump on Not Less or Equal 
Jump on Not Overflow 
Jump on Not Parity 

Jump on Not Sign 

Jump on Not Zero 

Jump on Overflow 

Jump on Parity 

Jump on Parity Even 

Jump on Parity Odd 

Jump on Sign 

Jump on Zero 

Load AH with Flags 
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Table E-1 ASM-86 Instruction Summary (cont'd) 


MNEMONIC DESCRIPTION 


Load Pointer into DS 

Load Effective Address 

Load Pointer into ES 

Lock Bus 

Load Byte or Word (of string) 
Loop 

Loop While Equal 

Loop While Not Equal 

Loop While Not Zero 

Loop While Zero 

Move 

Move Byte or Word (of string) 
Multiply 

Negate 

Not 

Or 

Output Byte or Word 


Push Flags 

Rotate through Carry Left 
Rotate through Carry Right 
Repeat 

Return (intra segment) 
Return (inter segment) 
Rotate Left 

Rotate Right 

Store AH into Flags 

Shift Arithmetic Left 

Shift Arithmetic Right 
Subtract with Borrow 

Scan Byte or Word (of string) 
Shift Left 

Shift Right 

Set Carry 

Set Direction 
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Table E-1 ASM-86 Instruction Summary (cont'd) 


MNEMONIC 


DESCRIPTION 


Set Interrupt 

Store Byte or Word (of string) 
Subtract 

Test 

Wait 

Exchange 

Translate 

Exclusive Or 
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sample Program 


Listing F-1 Sample Program APPF.A86 
CP/M ASM86 1.1 SOURCE: APPF.A86 Terminal Input/Output PAGE I 


title "Terminal Input/Output’ 

pagesize 50 

pagewidth 79 

simform 

.жжжжжж Terminal I/O subroutines ******** 


The following subroutines 
are included: 


CONSTAT — console status 
CONIN — console input 
CONOUT — console output 


Each routine requires CONSOLE NUMBER 
in the BL — register 


KK K K kK K K OK ЖЖЖ K K K K 


* Jump table: * 
2K OK K kK KK K K KK K K K K K K 


we we woe мо we we we we we woe we we we we we wo 


CSEG start of code segment 


Sample Program 
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0000 E90600 
0003 E91900 
0006 Е92В00 


CP/M А5М86 1.1 


0010 
0011 
0011 
0001 
0002 


0012 
0013 
0013 
0004 
0008 


0009 53Е83Ғ00 


000D 52 


jmp-tab: 
jmp constat 
jmp conin 
jmp conout 


KKK K kK K K K K K K k Æ K K K K k k K K 


Ж I/O port numbers * 
ЖЖЖЖЖЖЖЖЖЖЖЖЖЖЖЖЖЖЖЖЖЖ 


we woe we we we 


SOURCE: APPF.A86 Terminal Input/Output PAGE 2 


, 


: Terminal 1: 
instat] equ 10h ; Input status port 
indatal equ ПЕ ; input port 
outdatal equ lth ; output port 
readyinmaskl equ Olh ; Input ready mask 
readyoutmaskl equ 02h ; output ready mask 
І Terminal 2: 
instat2 equ 12h ; input status port 
indata2 equ 13h ; input port 
outdata2 equ 13h ; output port 
readyinmask2 equ 04h ; Input ready mask 
readyoutmask2 equ 08h ; output ready mask 
: ЖЖЖЖЖЖ ЖЖЖ... 
; * CONSTAT * 
3 SK ok ok ok ok жж ж ok ok ok 
: Entry: BL -reg - terminal no 
; Exit: AL - reg = 0 if not ready 
: Offh if ready 
constat 

push box ! call okterminal 
constat]: 

push dx 


000Е В600 
0010 8А17 
0012 ЕС 
0013 224706 
0016 7402 
0018 BOFF 


CP/M А5М86 1.1 


mov dh,0 


Sample Program 


; read status port 


mov dhlnstatustab [BX] 


in al,dx 


and  al,readyinmasktab [bx] 
jz constatout 


mov al,Offh 


SOURCE: APPF.A86 Terminal Input/Output PAGE 3 


constatout: 


001A 5А5ВОАСОСЗ 


001Ғ 53Е82900 
0023 E8E7FF 
0026 74FB 
0028 52 

0029 В600 
002В 8A5702 
002Е ЕС 

002F 247F 
0031 5А5ВСЗ 


, 
э 
. 
2 
2 
э 
. 
> 
. 
9 
, 
• 
э 


conin: 
coninl: 


ae we we we we we we we we we 


pop dx ! pop bx ! or al,al ! ret 


KK k K k K k K K k 


* CONIN * 


aK k ak k kK K 2K k 2 2 


Entry: BL - reg = terminal no 
Exit: AL - reg = read character 


push bx ! call okterminal ! 

call constat! ; test status 

ji coninl 

push dx ; read character 
mov аһ,0 

mov dl,indatatab [BX] 

in al,dx 

and al,7fh | ; strip parity bit 
pop dx! pop bx! ret 


xk ok ok ok ok ake ok oke aie ok oke ok 


* CONOUT * 


3k ok ok ok ake ok ok ok ok ok oe 


Entry: BL - reg - terminal no 
AL - reg - character to print 
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0034 53E81400 conout: push bx ! call okterminal 
0038 52 push dx 
0039 50 push ax 
003A B600 mov dh,0 ; test status 
003C 8A17 mov dl,instatustab [BX] 
conoutl: 
003E EC in al,dx 


CP/M ASM86 1.1 SOURCE: APPF.A86 Terminal Input/Output PAGE 4 


003F 224708 and al,readyoutmasktab[BX] 

0042 74FA jz  conoutl 

0044 58 pop ax ; write byte 

0045 8А 5704 mov dl,outdatatab [ВХ] 

0048 EE ош dx,al 

0049 5А5ВСЗ pop dx! pop bx! ret 
++++++++++++++ 
+ OKTERMINAL + 
++++++++++++++ 


Entry: BL - reg = terminal no 


Суз we we we we we we we we 


kterminal: 
004C OADB or  bl,bl 
004E 740A jZ error 
0050 80FB03 стр bl,length instatustab + 1 
0053 7305 jae error 
0055 FECB dec bl 
0057 B700 mov bh,0 
0059 C3 ret 
005A 5В5ВСЗ error: pop bx ! pop bx ! ret ; do nothing 


, 
КЕК кыны ыы ыы: епа of code segment ЖЖҰ kK K kK k KK K K K ЖЖ 


ak ək ЖЖЖ ЖЖ Ж 2 ək 2K Ok Ж 


* Data segment * 
KK k KKK ok KK K ok ok ok K K Ж 


, 
? 
. 
, 
. 
э 
9 


F-4 


0000 1012 
0002 1113 
0004 1113 
0006 0104 
0008 0208 


END OF ASSEMBLY. NUMBER OF ERRORS: 0 


dseg 


э 
е 
, 
. 
9 
э 


instatustab db 


indatatab db 
outdatatab db 


readyinmasktab db 
readyoutmasktab db 


Sample Program 


ak kak k kK k k ok ok ok ok ok ok ok ЖҰХЖЖЖЖЖЖЕЖЖ ЖЖ 


ж Data for each terminal % 
3k sk sk sk ok ok ok ok ok ok ok ok ok ok oe ok ok ok ok ok ok ok oe oe ok ok 


instat 1,instat2 

indatal,indata2 
outdatal,outdata2 
readyinmask 1 ,readyinmask2 
readyoutmask1,readyoutmask2 


, 
Ok ok ok ok ok ok ok ok ok ok ok ok ok Ж Ж 1 | ok ok Kok ok ok ok ok ok ok ok ok ok oko ok ok ok ok ok ok K 
: end of file 


end 


Appendix С 


<codemacro> : : = CODEMACRO <name> [<formal$list>] 
[«list$of$macro$directives?] 
ENDM 

<name> :: = IDENTIFIER 


<formal$list> : : = <parameter$descr>[{,<parameter$descr>}] 


<parameter$descr> : : = <form$name>:<specifier$letter> 
<modifier$letter>[(<range>)] 


<specifier$letter> ::=A|C|D]|E|M|R]|S| Х 
<modifier$letter> : : = b| wl dl sb 
«range? : : = «single$range?| <double$range> 


<single$range> : : = REGISTER | NUMBERB 


<double$range> :: = | NUMBERB, NUMBERB | NUMBERB, REGISTER | 
REGISTER, NUMBERB | REGISTER, REGISTER 
<list$of$macro$directives> : : = <macro$directive> 
{<macro$directive>} 
<macro$directive> : : = «db» | «dw» | «dd» | <segfix> | 


<nosegfix> | «modrm» | <relb> | 
<геім> | <dbit> 


«db» :: = DB NUMBERB| DB <form$name> 


G-1 


Codemacro Definition Syntax 


«dw» : : = DW NUMBERW | DW <form$name> 
«dd» : : = DD <form$name> 

<segfix> : : = SEGFIX <form$name> 

<nosegfix> : : = NOSEGFIX <form$name> 


<modrm> : : = MODRM МОМВЕВ7, «form$name» | 
MODRM «form$name», <form$name> 


<relb> : : = RELB <form$name> 
<relw> : : = RELW <form$name> 
<dbit> : : = DBIT <field$descr>{,<field$descr>} 


<field$descr> : : = NUMBERI5 ( NUMBERB ) | 
NUMBERIS5 ( «form$name» ( NUMBERB ) ) 


<form$name> : : = IDENTIFIER 


NUMBERB is 8 - bits 

NUMBERW is 16 - bits 

NUMBER аге the values 0, 1, ..., 7 
МОМВЕКІ5 are the values 0, 1, ..., 15 


Appendix H 


ASM-86 Error 
Messages 


ASM-86 produces two types of error messages: fatal errors and diagnostics. Fatal 
errors occur when ASM-86 is unable to continue assembling. Diagnostic messages 
report problems with the syntax and semantics of the program being assembled. 
The following messages indicate fatal errors encountered by ASM-86 during 
assembly: 


NO FILE 

DISK FULL 

DIRECTORY FULL 

DISK READ ERROR 
CANNOT CLOSE 

SYMBOL TABLE OVERFLOW 
PARAMETER ERROR 


ASM-86 reports semantic and syntax errors by placing a numbered ASCII message 
in front of theerroneous source line. If there is more than one error in the line, only 
the first one is reported. Table H-1 summarizes ASM-86 diagnostic error messages. 


Table H-1 ASM-86 Diagnostic Error Messages 


NUMBER MEANING 


ILLEGAL FIRST ITEM 
MISSING PSEUDO INSTRUCTION 


ILLEGAL PSEUDO INSTRUCTION 
DOUBLE DEFINED VARIABLE 
DOUBLE DEFINED LABEL 


ASM-86 Error Messages 


H-2 


Table H-1 ASM-86 Diagnostic Error Messages (cont'd) 


NUMBER MEANING 


UNDEFINED INSTRUCTION 
GARBAGE AT END OF LINE — IGNORED 
OPERAND (S) MISMATCH INSTRUCTION 
ILLEGAL INSTRUCTION OPERANDS 

MISSING INSTRUCTION 

UNDEFINED ELEMENT OF EXPRESSION 
ILLEGAL PSEUDO OPERAND 

NESTED "IF" ILLEGAL — "IF" IGNORED 
ILLEGAL “ТЕ” OPERAND — "IF" IGNORED 

NO MATCHING “IF” FOR “ENDIF” 

SYMBOL ILLEGALLY FORWARD REFERENCED — 
NEGLECTED | 

DOUBLE DEFINED SYMBOL — TREATED AS 
UNDEFINED 

INSTRUCTION NOT IN CODE SEGMENT 

FILE NAME SYNTAX ERROR 

NESTED INCLUDE NOT ALLOWED 

ILLEGAL EXPRESSION ELEMENT 

MISSING TYPE INFORMATION IN OPERAND (S) 
LABEL OUT OF RANGE 

MISSING SEGMENT INFORMATION IN OPERAND 
ERROR IN CODEMACRO BUILDING 


„s~n Appendix I 


DDT-86 Error Messages 


Table I-1 DDT-86 Error Messages 


ERROR MESSAGE MEANING 


AMBIGUOUS OPERAND 


CANNOT CLOSE 
a 
DISK READ ERROR 
DISK WRITE ERROR 
INSUFFICIENT MEMORY 
MEMORY REQUEST DENIED 
^^ 


An attempt was made to assemble а 
command with an ambiguous oper- 
and. Precede the operand with the 
prefix “BYTE” or “WORD”. 


The disk file written by a W com- 
mand cannot be closed. 


The disk file specified in an R com- 
mand could not be read properly. 


A disk write operation could not be 
successfully performed during a W 
command, probably due to a full 
disk. 


There is not enough memory to load 
the file specified in an R or E com- 
mand. 


A request for memory during an R 
command could not be fulfilled. Up 
to eight blocks of memory may be 
allocated at a given time. 


DDT-86 Error Messages 


Table I-1 DDT-86 Error Messages (cont'd) 


ERROR MESSAGE MEANING 


NO FILE The file specified in an R or E com- 
mand could not be found on the disk. 


NO SPACE There is no space in the directory for 
the file being written by a W com- 
mand. 


VERIFY ERROR AT s:o The value placed in memory by a Fill, 
Set, Move, or Assemble command 
could not be read back correctly, 
indicating bad RAM or attempting to 
write to ROM or nonexistent memory 
at the indicated location. 


I-2 


Іпдех 


А 
ААА 4-6 
AAD 4-6 
ААМ 4-6 
AAS 4-6 
ADC 4-6 
ADD 4-7 
Address conventions in ASM-86 2-16 
Address expression 2-16 
Allocate storage 3-6 
AND 4-8 
Arithmetic instructions 4-6 
Arithmetic operators 2-10 
ASM-86, aborting 1-4 
error messages Н-І 
instruction summary E-l 
Assembly language syntax 2-І, 2-4 


B 
Bracketed expression 2-16 
BYTE 2-7 


C 

CALL 4-12, 4-13 
CALLF 4-13 
CBW 4-7 
Character string 2-4 
CLC 4-17 

CLD 4-17 

CLI 4-17 

CMC 4-17 
CMP 4-7 
CMPS 4-11 
Code segment 3-1 
Codemacro 5-1 


— 
ALL. 
^m», C а, 
LLZ 
CL LIA 


—<t 
С 
ft 


definition syntax  G-1 

directives 5-5 

modifiers 5-4 

range specifiers 5-4 

specifiers 5-3 
Comments 2-17 
Conditional assembly 3-4 
Console output 1-4 
Constants 2-3 
Control transfer instructions 4-12 
Creation of output files 1-3 
CSEG 3-2 
CWD 4-7 


D 
DAA 4-7 
DAS 4-7 
Data segment 3-1 
Data transfer instructions 4-3 
DB 3-5, 5-8 
DBIT 5-8 
DD 3-5, 5-8 
DDT-86 commands, 6-2 
A (Assemble) 6-2 
conventions 6-1 
D (Display) 6-2 
E (Load for Execution) 6-2 
F (Fill) 6-2 
G(Go) 6-2 
H (Hexadecimal Math) 6-2 
I (Input Command Tail) 6-2 
L (List) 6-2 
M (Move) 6-2 
R (Read) 6-2 
S (Set) 6-2 


Index-1 


Іпдех 


summary 6-2 
Т (Тгасе) 6-2 
U (Untrace) 6-2 
У (Value) 6-2 
W (Write) 6-2 


X (Examine CPU) 6-2 
DDT-86, error messages І-1 


DDT-86, invoking 6-1 


DDT-86, terminating 6-3 


DEC 4-7 


Default segment values 6-13 


Defined data area 3-5 
Delimiters 2-1 
Directive statement 2-17 
DIV 4-7 


Dollar sign operator 2-14 


DSEG 3-2 
DW 3-6, 5-8 
DWORD 2-7 


E 

Effective address 3-1 
EJECT 3-8 

END 3-5 
End-of-line 2-17 
ENDIF 3-4 

EQU 3-5 

Error messages H-1, I-1 
ESC 4-17 
Expressions 2-16 
Extra segment 3-3 


Е 

Filename extensions 1-1 
Flag bits 4-2 

Flag registers 4-3 
Formal parameters 5-1 


H 
HLT 4-17 


Index-2 


I 

Identifiers 2-4 

IDIV 4-7 

IF 3-4 

IMUL 4-8 

IN 4-3 

INC 4-7 

INCLUDE 3-4 
Initialized storage 3-6 
Instruction statement 2-17 
INT 4-13 

INTO 4-13 

Invoking ASM-86 1-1 
IRET 4-13 


J 

JA 4-13 
JAE 4-13 
JB 4-13 
JBE 4-14 
JC 4-14 
JCXZ 4-14 
JE 4-14 
JG 4-14 
JGE 4-14 
JL 4-14 
JLE 4-14 
JMP 4-14 
JMPF 4-14 
JMPS 4-14 
JNA 4-14 
JNAE 4-14 
JNB 4-15 
JNBE 4-15 
JNC 4-15 
JNE 4-15 
JNG 4-15 
JNGE 4-15 
JNL 4-15 
JNLE 4-15 


JNO 4-15 
JNP 4-15 
JNS 4-15 
JNZ 4-15 
JO 4-15 
JP 4-15 
JPE 4-15 
JPO 4-15 
JS 4-15 
JZ 4-15 


K 
Keywords 2-5 


L 

Labels 2-7 

LAHF 4-3 

LDS 4-4 

LEA 4-4 

LES 4-4 

LIST 3-9 

Location counter 3-3 
LOCK 4-17 

LODS 4-11 

Logical operators 2-9 
LOOP 4-16 
LOOPE 4-16 
LOOPNE 4-16 
LOOPNZ 4-16 
LOOPZ 4-16 


M 

Mnemonic 2-17 
MODRM 5-6 
MOV 4-4 
MOVS 4-11 
MUL 4-8 


N 

Name field. 2-18 
NEG 4-8 
NOLIST 3-9 


Index 


NOSEGFIX 5-6 

NOT 4-9 

Number symbols 2-8 
Numeric constants 2-3 
Numeric expression 2-16 


O 

Offset 2-7 

Offset value 3-1 
Operand types 4-1 
Operator precedence 2-15 
Operators 2-8 

Optional runtime parameters 1-3 
OR 4-9 

Order of operations 2-15 
ORG 3-3 

OUT 4-4 

Output files 1-1 


P 

PAGESIZE 3-8 
PAGEWIDTH 3-8 
Period operator 2-14 
POP 4-4 

POPF 4-4 

Predefined numbers 2-5 
Prefix instructions 4-12 
Printer output 1-4 
Processor control instructions 4-16 
PTR operator 2-14 
PUSH 4-5 

PUSHF 4-5 


R 

Radix indicators 2-3 
RB 3-7 

RCL 4-9 

RCR 4-9 

Registers 2-6 
Relational operators 2-9 
RELB 5-7 

RELW 5-7 


Index-3 


Index 


REP 4-12 
REPE 4-12 
REPNE 4-12 
REPNZ 4-12 
REPZ 4-12 
RET 4-16 
RETF 4-16 
ROL 4-9 
ROR 4-9 
RS 3-7 
Runtime options 1-3 
RW 3-7 


5 

SAHF 4-5 

SAL 4-9 

SAR 4-10 

SBB 4-8 

SCAS 4-11 

SEGFIX 5-5 

Segment 2-7 

Segment base values 3-1 
Segment override operator 2-10 
Segment start directives 3-1 
Separators 2-1 

Shift instructions 4-8 
SHL 4-10 

SHR 4-10 

SIMFORM 3-9 

SSEG 3-3 

Stack segment 3-3 
Statements 2-7 

STC 4-17 

STD 4-17 

STI 4-17 

STOS 4-11 

String constant 2-4 
String instructions 4-4 
SUB 4-8 

Symbols 2-6 


Index-4 


T 

TEST 4-10 
TITLE 3-8 
Tokens 2-1 
Type 2-7 


U 
Unary operators 2-13 


V 


Variable manipulator 2-11 
Variables 2-13 


W 
WAIT 4-17 
WORD 2-7 


X 

XCHG 4-5 
XLAT 4-5 
ХОК 4-11 


— | | i—— 


Please cut along this line. 
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